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COURSE DESCRIPTION 



F01 Multics Concepts and Utilization 



Duration : 
Intended For: 

Course Synopsis: 



Objectives: 



Five Days 

Personnel requiring 
system. 



capability to use the Multics 



Prerequisite : 



This course presents the basic information needed 
to use the Multics system, including discussions 
and examples of: the typing conventions used for 
Multics terminals; a Multics text editor; 
commands used to write, compile and execute 
programs; utility command which provide of the 
user environment, manipulation of files, and 
inter-user communication; and the types of errors 
which can occur, with procedures for recovery. A 
general overview of Multics hardware and soft **dt e 
facilities is also presented. 

Interactive workshops are included to reinforce 
the material presented. 

Upon completion of this course, the student should 
be able to: 

1. Login to and logout from the Multics system. 

2. Create and edit files in the Storage system 
with the qedx text editor. 

3. Compile, run, and debug simple programs, and 
manipulate the run-time environment. 

4. Use other system commands to manipulate files, 
tailor the user environment, and communicate 
with other users. 

Programming Logic and Flowcharting (0024) or 
previous data processing experience. 
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Multics Overview 
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Workshop #1 


qedx Basics 
Workshop #2 
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The Command Language 

ExeG_cora Basics 
The Abbrev Processor 
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Programming on Multics 
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Access Control 
User Communication 
Input/Output Facilities 
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More Abbrev Processor 

Active Functions 
More About Exec__com's 
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Absentee Usage 
Software Conventions 
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Additional Commands 
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Hardware Overview 

Questions 
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STUDENT BACKGROUND 
Multics Concepts and Utilization (F01) 



NAME: PHONE: 

TITLE: 

COMPANY ADDRESS: 



MANAGER: , OFFICE PHONE: 



INSTRUCTOR'S NAME: PA^/^Y C^Af/^ 



Do you meet the prerequisite as stated in the "Course Description" 
of the student text? If yes, check "a" or "b". 
If no , check "c" or "d" . 

a [ ] Prerequisite satisfied by attending course indicated in 
"Course Description". 

b [ ] Meet prerequisite by equivalent experience (explain briefly) 



c [ ] Elected or instructed to attend course anyway, 
d [ ] Was not aware of prerequisite. 

What related Honeywell courses have you attended? Furnish dates 
and instructors if possible. 



(PLEASE TURN OVER) 
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STUDENT BACkGROUND 



Check the boxes for which you have any related experience, (May 
be other than Honeywell's) 

[ ] PL1 [ ] COBOL [ 3 FORTRAN [ ] ASSEMBLY 

[ ] JCL [3 OPERATIONS [ 3 GCOS [ ] MULTICS 

[ 3 OTHER COMPUTER RELATED 



Detail any Multics experience you have had: 



Objectives for attending this course (May check more than one). 

[ 3 Require information to provide support for a Multics system 

[ 3 To maintain an awareness of this product 

[ 3 To evaluate or compare its potentials 

[ 3 Required to use or implement 

[ 3 Need update from a previous release 

[ 3 Require a refresher 

[ 3 Other; 
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TOPIC 1 



MULTICS OVERVIEW 



Page 

Some Basic Terminology 1-1 

Development History 1-5 

Multics Design Goals and Results .... 1-9 

Administration 1-15 
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SOME BASIC TERMINOLOGY 



• HARDWARE 



REFERS TO THE PHYSICAL COMPONENTS OF A COMPUTER; ESPECIALLY TO 
THE ELECTRONIC CIRCUITRY 



MAJOR COMPONENTS: CENTRAL PROCESSOR UNIT (CPU), MAIN MEMORY, 
DISK DRIVES, TAPE UNITS, PRINTER, CARD READER, CARD PUNCH 



• SOFTWARE 



REFERS TO THE PROGRAMS, PROCEDURE, CODE, OR INSTRUCTIONS THAT 
EXECUTE ON THE HARDWARE 



EXAMPLES: A FORTRAN PROGRAM, THE PL/I COMPILER, THE DATA BASE 
MANAGER, THE OPERATING SYSTEM 



1- 1 For 



SOME BASIC TERMINOLOGY 



SYSTEM RESOURCES 



B CENTRAL PROCESSOR / CPU (TIME OCCUPIED) 



MAIN MEMORY / PRIMARY MEMORY / CORE (AMOUNT OCCUPIED » TIME 
OCCUPIED) 



D PERIPHERAL DEVICES 

D DISK DRIVES (AMOUNT OF DATA TRANSFERRED) 
D TAPE DRIVES (AMOUNT OF DATA TRANSFERRED) 
D CARD PUNCH (AMOUNT OF DATA PUNCHED) 
D PRINTER (AMOUNT OF DATA PRINTED) 

fl TERMINALS (CONNECT TIME & AMOUNT OF DATA TRANSFERRED) 
D MEDIA 

D DISK PACKS / SECONDARY MEMORY (AMOUNT OF DATA STORED) 

fl TAPES (NUMBER USED) 

Q CARDS (NUMBER PUNCHED) 

fl PRINTER PAPER (AMOUNT USED) 

Q SYSTEM AND SITE PROVIDED SOFTWARE (RENTAL) 
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SOME BASIC TERMINOLOGY 



BIT ' 
G THE MOST FUNDAMENTAL UNIT OF INFORMATION 
D A BIT IS EITHER ON OR OFF (1 OR 0) 

BYTE 

B A SMALL UNIT FOR MEASURING THE AMOUNT OF MEMORY, THE SIZE OF A 
PROGRAM OR FILE, OR THE SPACE ON A TAPE OR DISK PACK 

D ON MOST LARGE SCALE HONEYWELL EQUIPMENT, A BYTE EQUALS 9 BITS 

fl ON MULTICS, ONE ASCII CHARACTER OCCUPIES ONE BYTE 



WORD 

0 A LARGER UNIT FOR MEASURING THE AMOUNT OF MEMORY, THE SIZE OF A 
PROGRAM OR FILE, OR THE SPACE ON A TAPE OR DISK PACK 

B ON MOST LARGE SCALE HONEYWELL EQUIPMENT, A WORD E QUALS 4 BYTES 
OR 36 BITS 
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SOME BASIC TERHINOLOGY 



• USER 

0 ONE WHO USES THE COMPUTER FACILITY 

• PROJECT 

0 A SET OF USERS GROUPED TOGETHER FOR ACCOUNTING AND ACC^^SS 
PURPOSES 

D A PROJECT IS OFTEN A GROUP OF USERS WORKING TOWARDS A COMMON 
GOAL 

D USERS ON A PROJECT OFTEN WORK FOR THE SAME DEPARTMENT OR UNIT 
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DEVELOPMENT HISTORY 

• MULTICS 

0 MULT IPLEXED INFORMATION AND COMPUTING SERVICE 

• 1960-1963: CTSS DEVELOPMENT 

a FIRST LARGE-SCALE TIME-SHARING SYSTEM 

fl EXPERIENCED GAINED WAS USED LATER IN THE MULTICS PROJECT 
B CTSS WAS USED TO DEVELOP MULTICS SOFTWARE 

• 1964: INITIAL SPECIFICATIONS FOR MULTICS 
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DEVELOPMENT HISTORY 



• 1964-1965: INITIAL MULTICS DEVELOPMENT WAS A JOINT EFFORT BY: 

D MASSACHUSETTS INSTITUTE OF TECHNOLOGY (PROJECT MAC) 
B OVERALL PROJECT CO-ORDINATION 
D OPERATING SYSTEM 

fl SELECTION AND DESIGN MODIFICATIONS OF THE HARDWARE (GE 63^ . ■ 

0 BELL TELEPHONE LABORATORIES 
B COMPILERS AND ASSEMBLER 
fl FILE SYSTEM 

D GENERAL ELECTRIC COMPUTER DIVISION (HONEYWELL) 
D HARDWARE MODIFICATION 

• 1965: FALL JOINT COMPUTER CONFERENCE 
fl PRIMARY TECHNICAL PAPERS PRESENTED 
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DEVELOPMEHT HISTORY 

• 1967: GE 645 HARDWARE AVAILABLE (MODIFIED GE 635) 

• 1967: SOFTWARE DEVELOPMENT UNDERWAY 

• 1968: AVAILABLE TO SYSTEM PROGRAMMERS 

• 1969: AVAILABLE FOR USE AT MIT 

• 1971: PROJECT MAC FUNDING STOPPED. HIS ADOPTS. 

• 1972: 6180 HARDWARE AVAILABLE 
D BULK STORE REPLACED DRUM 

a EXTENDED INSTRUCTION SET (EIS) 
0 RING MECHANISM MOVED TO HARDWARE 
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DEVELOPMENT HISTORY 



1973: ANNOUNCED AS A "STANDARD" HIS PRODUCT 



1974: LEVEL 68 HARDWARE 



0 68/60 MOS MEMORY 



D 68/80 MOS MEMORY AND CACHE STORE 



• 1975: COBOL-74 



1975: SORT/MERGE 



• 1976: MULTICS DATA BASE MANAGER (MDBM) 



• 1977: WORD PROCESSING SYSTEM (WORDPRO) 
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MULTICS DESIGN GOALS AND RESULTS 

• REMOTE TERMINAL ACCESS AS NORMAL USAGE MODE 

2 ALL SYSTEM RESOURCES AVAILABLE VIA TERMINALS 

D USAGE OF CARDS IS MINIMAL 

D INTERACTIVE AND BATCH ENVIRONMENTS ARE COMPATIBLE 

II INTER-USER COMMUNICATION 

• CONTINUOUS/UTILITY GRADE OPERATION 

0 EXTREMELY STABLE OPERATING SYSTEM 
I MODULAR DESIGN 

I WRITTEN IN PL/I 

Q ON LINE METERING, ACCOUNTING, BILLING AND SOFTWARE INSTALLATION 
D OPERATORS REQUIRED: ONE 

1 UNATTENDED OPERATION MODE 
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MULTICS DESIGN GOALS AND RESULTS 

ABILITY TO GROW AND CONTRACT WITHOUT SYSTEM OR USER REORGANIZATION 

0 SYSTEM SIZE - TRANSPARENT TO USERS, PROGRAMS, AND OPERATING 
SYSTEM 

D CHANGES TO SYSTEM SIZE ARE MADE WITHOUT REGENERATING THE 
OPERATING SYSTEM OR USER PROGRAMS 

fl DYNAMIC RECONFIGURATION - TRANSPARENT TO USERS AND PROGRAr^S 

DECENTRALIZATION OF THE SYSTEM'S ADMINISTRATION 

D HIERARCHY OF ADMINISTRATORS: 
D THE SYSTEM ADMINISTRATOR 
D PROJECT ADMINISTRATORS 
fl USERS 



1-10 



F01 



MULTICS DESIGK GOALS AND RESULTS 

• DECENTRALIZATION OF THE SYSTEM »S LOGICAL FILE SPACE 

fl HIERARCHY OF DIRECTORIES: 
i ROOT DIRECTORY 
fl SYSTEM DIRECTORIES 
1 PROJECT DIRECTORIES 
Q USER DIRECTORIES 

• RELIABLE FILE SYSTEM 

Q INCREMENTAL BACKUP SYSTEM (Backup SysDaemon) 
0 AUTOMATED RETRIEVAL 
11 SALVAGE SUBSYSTEM 
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HULTICS DESiGH GOALS AND RESULTS 

ACCESS CONTROLS THAT ALLOW SELECTIVE SHARING OF INFORMATION AND 
SERVICES 

i MULTICS IS THE MOST SECURE COMMERCIAL OPERATING SYSTEM 
AVAILABLE 

0 USER AUTHENTICATION (BY PASSWORD) 

D ACCESS CONTROL LIST - ACL (BY NAME AND PROJECT) 

fl ACCESS ISOLATION MECHANISM AIM (BY SECURITY LEVEL AND NEED TO 
KNOW) 

fl RING STRUCTURE (8 LEVEL MASTER/SLAVE HIERARCHY) 
SERVES BOTH LARGE AND SMALL USERS EFFICIENTLY 

D RESOURCES ARE AUTOMATICALLY ALLOCATED ON DEMAND - WHEN NEEDED, 
AND IN PROPORTION TO THE SIZE OF THE TASK 
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HULTICS DESIGN GOALS AMD RESULTS 



• COMBINE SYSTEM FLEXIBILITY WITH EASE OF USE 
S VIRTUAL MEMORY 

fl ONLY ONE STORAGE SYSTEM FOR BOTH USERS AND OPERATING SYSTEM 

D ASCII CHARACTER SET USED THROUGHOUT 

II INTERACTIVE AND BATCH ENVIRONMENTS ARE COMPATIBLE 

B EXEMPLARY COMMAND LANGUAGE (NO JCL!) 

D COMMAND NAMES 

fl FULL NAME (DESCRIPTIVE) 
II SHORT NAME (CONVENIENT) 

11 CONTROL ARGUMENTS WITH INTELLIGENT DEFAULTS 

D ACTIVE FUNCTIONS 

I STAR AND EQUAL CONVENTION 

I! COMMAND ITERATION 

II ABBREV PROCESSOR 

Q EXEC COMS (COMMAND FILES) 
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MULTICS DESIGN GOALS AMD RESULTS 

DIFFERENT ENVIRONMENTS AND HUMAN INTERFACES WITHIN A SINGLE SYSTEM 

D STANDARD SERVICE (FULL MULTICS) 

D SUBSYSTEM (E.G. FAST, BASIC, APL) 

D LIMITED SERVICE 

0 TAILORED ENVIRONMENT 

EVOLUTIONARY DESIGN ABLE TO INCORPORATE TECHNOLOGICAL IMPROVEMENTS 
AND TO MEET GROWING USER EXPECTATIONS 

D MODULAR DESIGN 

D GENERAL (NOT SPECIFIC) SOLUTIONS 
D COMPATIBLE EXPANSIONS 
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ADMINISTRATION 



• THE EFFECTIVE ADMINISTRATION OF A LARGE COMPUTER INSTALLATION CAN 
BE A DIFFICULT JOB 

• FOR MULTICS, A HIERARCHY OF ADMINISTRATORS HAS BEEN DEFINED IN 
ORDER TO: 

fl DECENTRALIZE CONTROL OF SYSTEM RESOURCES BY DISTRIBUTING 
AUTHORITY AND RESPONSIBILITY TO LOWER LEVELS 

• THE MULTICS ADMINISTRATION HIERARCHY CONSIST OF THREE LEVELS: 

D SYSTEM ADMINISTRATOR(I) 

D PHYSICAL, ADMINISTRATIVE AND FINANCIAL CONCERNS OF THE 
SYSTEM 

B PROJECT ADMINISTRATOR (2) 

n ADMINISTRATIVE AND FINANCIAL CONCERNS OF THE PROJECT 

B USER 

fl CONTROL AND USAGE OF RESOURCES ALLOCATED TO HIM/HER 



(1) Related Multics Course: System Administration (F60) 

(2) Related Multics Course: Project Administration (F61) 
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ADMINISTRATION 



SYSTEM 
ADMINISTRATOR 



ProjA PROJECT 
ADMINISTRATOR 



JL 



F01 PROJECT 
ADMINISTRATOR 



USER 
May 



USER 
Kerr 



USER 
Abel 



USER 




USER 




USER 




USER 


S_01 




S_02 




S_03 




S_04 
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ADMINISTRATION 

• THE SYSTEM ADMINISTRATOR 

B ESTABLISHES SYSTEM CONFIGURATION AND OPERATING PARAMETERS 
(METERING AND TUNING) 

fl DEFINES, CREATES, AND ALLOCATES RESOURCES TO THE SYSTEM 
PROJECTS 

fl ADMINISTERS THE SYSTEM'S SECURITY NEEDS 

fl REGISTERS USERS AND ASSIGNS INITIAL (AND NEW) PASSWORDS 

fl MAINTAINS RECORDS OF SYSTEM USAGE 

fl SETS RESOURCE USAGE PRICES AND DETERMINES BILLING CYCLE 

fl GENERATES STATEMENT OF CHARGES TO RECOVER THE COST OF SYSTEM 
RESOURCES USED 

fl PERFORMS ALL OF THE ABOVE TASKS FROM A TERMINAL AND WITHOUT 
INTERRUPTION OF SERVICE 
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ADMINISTRATION 

• THE PROJECT ADMINISTRATOR 

D DISTRIBUTES RESOURCES AND ATTRIBUTES ALLOCATED TO PROJECT 

0 HAS ACCESS TO THE PROJECT'S RESOURCE USAGE AND ACCOUNTING DATA 
fl ADDS AND DELETES REGISTERED (AND ANONYMOUS) USERS TO PROJECT 

D DEFINES THE ENVIRONMENT AND SETS RESOURCE LIMITS FOR USERS 

1 SETS ACCESS ON USERS' HOME DIRECTORY 

• THE USER 

fl HAS CONTROL OVER RESOURCES ALLOCATED TO HIM 

D HAS ACCESS TO HIS OWN RESOURCE USAGE AND ACCOUNTING DATA 

fl MAY SELECTIVELY SHARE HIS PROGRAMS AND DATA WITH OTHER USERS 

II MAY CHANGE HIS PASSWORD 
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TOPIC II 



HOW TO ACCESS MULTICS 



Page 

Remote Terminal Access 2-1 

User Registration and Identification . 2-2 

Characteristics of Terminals 2-4 

Access Sequence 2-5 

login and logout Commands 2-6 

Typing Conventions 2-9 

Some Simple Commands 2-11 
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REMOTE TERMINAL ACCESS 

• REMOTE TERMINAL ACCESS IS THE NORMAL MODE OF ACCESS 

• ALL SYSTEM RESOURCES ARE ACCESSIBLE VIA REMOTE TERMINAL 

• USES STANDARD TELEPHONE LINES 

• "LOGGING IN" REFERS TO THE PROCESS OF: 
fl TELEPHONING THE MULTICS SYSTEM 

II CONNECTING THE TELEPHONE TO THE TERMINAL 
I WAITING FOR MULTlCS TO SEND YOU A GREETING 
fl IDENTIFYING YOURSELF TO THE SYSTEM 
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USER REGISTRATION AND IDENTIFICATION 



• NEW USERS ARE REGISTERED BY THE SITE SYSTEM ADMINISTRATOR 



ADMINISTRATOR ASSIGNS A Project_id, A UNIQUE Person_id, AND A 
PASSWORD 



Person id's Project id's PASSWORD 'S 



TSmith ProjA ts 

Greenberg ProjA $$$! 

Student 04 F01 atlanta 



• A USER MAY BELONG TO MORE THAN ONE PROJECT - HOWEVER, ONE PROJECT 
IS ALWAYS DESIGNATED AS THE USER'S "DEFAULT PROJECT" 

I 



• THE USER'S PASSWORD IS ASSOCIATED WITH HIS Person id ONLY 



• User__id 

D REFERS TO THE Person^id . Project__id PAIR 
TSmith. ProjA 
SWebber.Doc 66 



1 
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USER REGISTRATION AND IDENTIFICATION 



THE USER'S PASSWORD IS REQUIRED IN ORDER TO AUTHENTICATE THE USE 
OF THE USER'S Person id 



THE USER'S Person id AND Project id ARE THE KEYS THAT DETERMINE 
WHAT INFORMATION IND SERVICES Hi IS AUTHORIZED TO ACCESS AND 
CONTROL 



Password 



AUTHORIZES 
USE OF 




AUTHORIZES 
USE OF 



DESIGNATED FILES 
AND SERVICES 
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CHARACTERISTICS OF TERMINALS 



• TERMINALS BEHAVE LIKE ELECTRIC TYPEWRITERS 



• MANY HAVE SEPARATE »»CARRIAGE RETURN" AND "LINE FEED" KEYS 



• CONCEPTUALLY, THE "LINE FEED" KEY SENDS THE TYPED LINE 



• TERMINAL TO COMPUTER COUPLINGS: 

D HARDWIRED (A PERMANENT WIRE CONNECTS TERMINAL TO COMPUTER) 

0 TELEPHONE-MODEM (TELEPHONE LINE CONNECTS TERMINAL TO COMPUTER) 
D ACOUSTIC (PROXIMITY) 
D DIRECT (PUSH A BUTTON) 



TERMINAL SWITCHES: 



DUPLEX: 

CASE: 

PARITY: 




MODE: 
RATE: 



LINE 
30 



LOWER 
EVEN 
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ACCESS SEQUENCE 



PLUG-IN AND TURN ON THE TERMINAL 



SET THE TERMINAL SWITCHES 



• IF HARDWIRED TERMINAL 



D IDENTIFY YOURSELF VIA THE login COMMAND 



• IF TELEPHONE-MODEM TERMINAL 



II DIAL THE APPROPRIATE NUMBER AND WAIT FOR HIGH-PITCHED TONE 



0 CONNECT THE PHONE TO THE COUPLER DEVICE 



0 WAIT FOR MULTICS TO RESPOND WITH A MESSAGE SIMILAR TO 

Multics MR6.0: Honeywell LISD Phoenix, System M 
Load = 51.0 out of 95.0 units: users = 51 



0 IDENTIFY YOURSELF VIA THE login COMMAND 
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LOGIN AilD LOGOUT COMMANDS 



• login, 1 



D A COMMAND USED TO GAIN ACCESS TO MULTICS 



0 INITIATES A PROGRAM CALLED THE USER'S PROCESS 



Q USAGE: login Person_id {Project__id} 

1 TSmith 

1 TSmith FED 

1 Student 07 F01 



IF A Project__id IS NOT SPECIFIED THE USER'S DEFAULT Project_id 
IS ASSUMED 



RESULTS: THE USER WILL BE ASKED TO SUPPLY THE PASSWORD 
ASSOCIATED WITH HIS Person id 



0 A PASSWORD MASK WILL BE GENERATED -OR- PRINTING OF THE 
PASSWORD WILL BE INHIBITED 



D SUPPLYING THE CORRECT PASSWORD COMPLETES THE USER'S LOG IN 
SEQUENCE 



THE Project_id USED AT LOG IN DETERMINES WHO RECEIVES THE BILL 
FOR THE CURRENT TERMINAL SESSION 



E THE Person id AND Project__id USED AT LOG IN DETERMINES WHERE IN 
THE MULTIC^ VIRTUAL MEMORY THE USER "FINDS" HIMSELF 
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LOGIN AND LOGdUt COMMANDS 



<DIAL TELEPHONE NUMBER> 
<CONNECT TERMINAL/TELEPHONE> 
<WAIT FOR LOGIN HERALD> 

Multics MR6.0: Honeywell LISD Phoenix, System M 
Load = 51.0 out of 95.0 units: users = 51 

1 TSmith 
Password 
EEfiBKHBBBEHH 

TSmith ProjA logged in 06/28/77 1553.2 mst Tue from terminal »»243" 
Last login 06/28/77 1^25.8 mst Tue from terminal "013" 
A new PL/1 compiler was installed; type help new^pll. 
Type help sked for hours of operation FW31. ~ 
r 1553.5 1.314 1.332 30 



READY MESSAGE 



A MESSAGE THAT IS PRINTED EACH TIME THE USER IS AT "COMMAND 
LEVEL" 



0 THE READY MESSAGE REPORTS 
D THE TIME OF DAY 

D THE NUMBER OF CPU SECONDS USED SINCE THE LAST READY MESSAGE 
D THE NUMBER OF MEMORY UNITS USED SINCE THE LAST READY MESSAGE 



THE NUMBER OF PAGES (102^* WORDS) BROUGHT INTO MEMORY FOR THE 
USER SINCE THE LAST READY MESSAGE 
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LOGIN AND LOGOUT COMMANDS 

logout 

0 INFORMS MULTICS THAT THE USER IS THROUGH WITH THE CURRENT 
TERMINAL SESSION 

0 USAGE: logout 

D RESULTS: THE USER WILL BE DISCONNECTED FROM MULTICS 
logout 

TSmith ProjA logged out 06/28/77 17^9-^ mst Tue 
CPU usage 17 sec, memory usage 103.1 units 
hangup 

new^proc 

0 DESTROYS THE USER'S CURRENT PROCESS AND CREATES A NEW ONE 

D EFFECTIVELY THE SAME AS LOGGING OUT AND LOGGING IN AGAIN 

0 OFTEN USED »»WHEN ALL ELSE FAILS" OR TO RESET THE USER'S 
ENVIRONMENT 

0 USAGE: new proc 
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TYPING COHVENtiONS 



• # (NUMBER SIGN) 

fl USED TO "ERASE" THE PREVIOUS CHARACTER 

login TSM#mith 
login TSMith####mith 
logen#j|fin TSine#ith 
logim T###n TSmith 

M NOTE: WHITE SPACE IS COUNTED AS ONE CHARACTER WHEN USING THE 
m ERASE CHARACTER 

• @ (AT SIGN) 

0 USED TO "KILL" THE CURRENT LINE 

login TSMithglogin TSiaith 

logen§login TSme#ith 

logen##im#n Tsm##Sme§login TSmith 
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TYPING CONVENTIONS 



• \ (BACKSLASH) 



fl THE CHARACTER \ IS A FRONT-END PROCESSOR ESCAPE SEQUENCE THAT 
CAUSES CERTAIN CHARACTER THAT FOLLOWS TO BE INTERPRETED AS A 
LITERAL 



0 OFTEN USED TO SUPPRESS (ESCAPE) THE SPECIAL MEANING OF #, @, 
linefeed AND OTHER SPECIAL CHARACTERS 



sm TSmith.ProjA I need a \#8 tin can. 



sm TSmith.ProjA He's selling 3 \§ $4.50 each. 



COMMAND LINE FLOW 



TYPED LINE 



(AT THE TERMINAL) 



FRONT-END PROCESSOR 



(# AND @ EDITING AND LINE DISCIPLINE) 




COMMAND PROCESSOR 



(INTERPRETS THE TYPED LINE) 



EXECUTION 
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SOME SIMPLE COMMANDS 



who 



fl LISTS THE NAMES AND PROJECTS OF ALL USERS CURRENTLY LOGGED IN 



D USAGE: who {args} {-control_args} 
who 

who -name 

who -long 

who TSmith 

who .ProjA 

who May .F01 .ProjA 




how many users, hmu 



fl TELLS HOW MANY USERS ARE CURRENTLY LOGGED IN 



fl USAGE: how_many__users {args} {-control_args} 
hmu 

hmu -long 

hmu TSmith 

hmu .ProjA 

hmu May .F01 .ProjA 
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SOME SIMPLE COMMANDS 
help (YA WANT IT, WE GOT IT) 

1 PROVIDES INFORMATION ABOUT THE MULTICS SYSTEM AND ITS COMMANDS 

1 USAGE: help {name} 
help who 
help sked 
help help 

D ANSWER: yes. no, rest, skip, section str, search sA sB ... 
list, Is (ROLL CALL) 

0 RETURNS INFORMATION ABOUT THE USERS SEGMENTS (FILES) 

fl USAGE: list 
Is 
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SOME SIMPLE COMMANDS 



accept^messages, am (I'M LISTENING) 

S ENABLES THE USER TO RECEIVE MESSAGES AT HIS TERMINAL 

I OTHERWISE, MESSAGES WILL GO TO THE USER'S MAILBOX (A SEGMENT 
HAVING THE NAME Person_id .mbx) 

D CREATES A PERMANENT MAILBOX FOR THE USER IF NONE EXISTS 

I USAGE: accept_messages 
am 

send_message , sm 

0 SENDS MESSAGES TO A GIVEN USER ON A GIVEN PROJECT 

1 MESSAGES ARE EITHER: 

I PRINTED ON THE RECIPIENT'S TERMINAL, OR 
a PLACED IN THE RECIPIENT'S MAILBOX 

i USAGE: send_message Person__id . Project_id message 

sm TSmith.ProjA When are you going to lunch? 

sm Greenberg .FED May I have access to your file? 
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SOME SIMPLE COMMANDS 

• print_messages , pm 

0 PRINTS ALL MESSAGES STORED IN THE USER'S MAILBOX 

D MESSAGES ARE DELETED FROM THE MAILBOX WHEN PRINTED 

fl USAGE: print_messages 
pm 

• defer_messages, dm (I'M BUSY... NO DISTRACTIONS WANTED) 

0 REDIRECTS ANY AND ALL INCOMING MESSAGES TO THE USER'S MAILBOX 

D ELIMINATES UNWANTED INTERRUPTIONS 

B THIS IS THE DEFAULT UPON LOGIN 

D "UNDONE" BY THE accept__message COMMAND 

Q USAGE: def er_messages 
dm 
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SOME SIMPLE COMMANDS 



YOU ARE NOW READY FOR WORKSHOP 
#1 
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TOPIC III 



QEDX BASICS 



Page 

What is qedx . 3-1 

qedx Concepts 3-2 

Basic qedx Requests 3-5 

Basic qedx Examples 3-8 
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mkt IS QEDX 



qedx, qx 

Q ONE OF SEVERAL TEXT EDITORS AVAILABLE ON MULTICS USED TO 
0 MODIFY THE CONTENTS OF EXISTING ASCII SEGMENTS 
0 CREATE (INPUT) THE CONTENTS OF DESIRED ASCII SEGMENTS 

Q A SUBSYSTEM WHICH CAN ONLY BE ENTERED BY COMMAND, AND EXITE 
REQUEST 




COMMAND LINE FLOW 



TYPED LINE 
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QEDX CONCEPTS 



USER INVOKES THE EDITOR BY TYPING qedx OR qx 



THERE ARE TWO PRINCIPAL MODES OF OPERATION WITHIN qedx 



Q EDIT MODE 



B THE INITIAL (DEFAULT) MODE WHEN ENTERING qedx 



0 THE USER READS THE CONTENTS OF AN EXISTING SEGMENT INTO A 
BUFFER (A SCRATCH PAD) 

D THE USER THEN PERFORMS EDITING FUNCTIONS ON THE CONTENTS OF 
THE BUFFER BY TYPING EDIT REQUESTS: 

0 LOCATING 

B SUBSTITUTING • 

B DELETING 

B PRINTING 

B THE USER THEN WRITES (SAVES) THE EDITED VERSION OF THE 
SEGMENT BACK TO THE SAME (OR A NEW) SEGMENT 



B INPUT MODE 



B THE USER ENTERS THE INPUT MODE (FROM THE EDIT MODE) BY 
TYPING ONE OF THREE INPUT REQUESTS 

B ALL SUBSEQUENT TEXT FROM THE TERMINAL (EXCEPT ESCAPE 
IRUENCES) IS APPENDED TO THE USER«S BUFFER (A SCRATCH PAD) 

B "\f" IS AN ESCAPE SEQUENCE THAT RETURNS THE USER TO THE EDIl 
MODE 

3-2 F01 



qiDX CONCEPTS 



• ALL LINES IN A qedx BUFFER ARE GIVEN IMAGINARY LINE NUMBERS 
STARTING WITH 1 (ONE) 

• THERE EXISTS A CONCEPTUAL POINTER TO INDICATE THE "CURRENT LINE" 

• qedx REQUESTS MAY DO ONE OR MORE OF THE FOLLOWING 
!l MOVE THE CONCEPTUAL POINTER 

fl PERFORM OPERATIONS ON THE CURRENT LINE 

3 PERFORMS OPERATIONS ON A SET OF LINES WITH 1 (ONE) 

• ALL LINES CAN BE ADDRESSED BY SUPPLYING THEIR LINE NUMBER. 
NO LINE NUMBER IMPLIES "CURRENT LINE" 

p (PRINT CURRENT LINE) 

5p (PRINT THE FIFTH LINE) 

3,9d (DELETE LINES 3 THROUGH 9) 
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QEDX CONCEPTS 



• THE ADDITION AND DELETION OF LINES AFFECT THE IMAGINARY LINE 
NUMBERS IMMEDIATELY 



• AFTER EACH qedx REQUEST, THE "CURRENT LINE" GENERALLY BECOMES THE 
LAST LINE ADDRESSED 



• FOR CONVENIENCE, THE LAST LINE CAN ALSO BE ADDRESSED BY USJ^'■. KE 
SYMBOL $ (DOLLAR SIGN) 
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BASIC QEDX REQUESTS 



EDIT REQUESTS DESCRIPTION 

r path READ: READ CONTENTS OF THE SEGMENT 

SPECIFIED BY path AND APPEND AFTER THE 
SPECIFIED LINE ($ ASSUMED) 



PRINT: PRINT THE SPECIFIED LINE(S) ON THE 
TERMINAL 



LINE NUMBER: PRINT LINE NUMBER OF SPECIFIED 
LINE 



DELETE: DELETE SPECIFIED LINE(S) FROM THE 
BUFFER 



/XXX/ LOCATE: LOCATE AND PRINT THE NEXT LINE 

CONTAINING THE xxx CHARACTER STRING. WRAP 
AROUND IF NECESSARY 



s/existing/new/ SUBSTITUTE: SUBSTITUTE EVERY OCCURRENCE OF 

THE EXISTING STRING WITH THE NEW CHARACTER 
STRING IN SPECIFIED LINE(S) 



w path WRITE: WRITE THE SPECIFIED LINE(S) OF THE 

BUFFER INTO SEGMENT HAVING THE NAME path 
(ENTIRE BUFFER IS THE DEFAULT) 



e commancl_line EXECUTE: PASS THE REMAINDER OF THE REQUEST 

LINE TO THE MULTICS COMMAND PROCESSOR FOR 
EXECUTION 



q QUIT: EXIT FROM THE EDITOR 
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BASIC QEDX REQUESTS 



DESCRIPTION 

APPEND: ENTER INPUT MODE AND APPEND THE 
LINE(S) TYPED AT THE TERMINAL AFTER THE 
SPECIFIED LINE 



INSERT: ENTER INPUT MODE AND INSERT THE 
LINE(S) TYPED AT THE TERMINAL BEFORE THE 
SPECIFIED LINE 



CHANGE: ENTER INPUT MODE AND REPLACE THE 
SPECIFIED LINE(S) WITH THE LINE(S) TYPED AT 
THE TERMINAL 
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BASIC QEDX REQllEStS 



ADDRESSING SYNTAX 



I qedx REQUEST MAY TAKE ONE OF THREE GENERAL FORMS 



I <request> - GENERALLY APPLIED TO THE CURRENT LINE 



r temp.pH 
P 

s/old/new/ 
d 

w add.pll 



(APPENDS TO END OF BUFFER) 




(WRITES THE ENTIRE BUFFER) 



fl ADR<requ€St> - APPLIED TO THE LINE ADDRESSED 

6r >udd>FED>Kerr>temp.pl1 
5p 

7s/old/new/ 
9d 

3w add.pll 

D ADR ,ADR<request> - APPLIED TO THE RANGE OF LINES ADDRESSED 



1 ,$p 

5, 15s/old/new/ 
9,12d 

1 ,20w add .pll 



If 
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BASIC QEDX EXAMPLES 



qedx 
a 

"Now is hte time 
for al good 
their county 
(Af7 




RESULTING BUFFER 



"Now is hte time 1 
for al good 2 
their county 3 



1,$p 

"Now is hte time 
for al good 
their county 
2d 

— 

for al good 
s/al/all/ 
$s/ty/try."/ 
P 

their country." 
w Henry. quote 



RESULTING BUFFER 



"Now is hte time 1 
for all good 2 
their country." 3 



/good/ 

for all good 
a 

men to come 
to hte aid of 
1 ,$p 
\f 



RESULTING BUFFER 



"Now is hte time 
for all good 
men to come 
to hte aid of 
1 ,$p 

their country." 
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BASIC QEDX EXAMPLES 



P 

l,$p 
d 

1 ,$s/hte/the/ 
w Henry. quote 



1,$cl 
a 

\f 



-Patrick Henry 



RESULTING BUFFER 



"Now is the time 
for all good 
men to come 
to the aid of 
their country." 



RESULTING BUFFER 



-Patrick iienry 



RESULTING BUFFER 



Qr Henry. quote 

their country." 
a 

\f 
1i 

FAMOUS QUOTE: 



\f 

w Henry. quote 



FAMOUS QUOTE: 



"Now i3 the time 
for all good 
men to come 
to the aid of 
their country." 



-Patrick Henry 



YOU ARE NOW READY FOR WORKSHOP 
#2 
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TOPIC IV 



MORE QEDX 



Page 

qedx Terminology 4-1 

Special Symbols ^-2 

Examples , . 4-6 

Addressing 4-7 

Additional Buffers ..... 4-9 

Areas for Additional Study 4-10 
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QEDX TERMINOLOGY 



RF.nni.AR EXPRESSION 1^ 



S ANY NUHBER OF CHARACTERS (INCLUDING NONE) DELIMITED BY A RIGHT 
SLANT AND OBEYING A CERTAIN SYNTAX 

/abc/ /a.c/ 

/old/ /old.»$/ 

/calendar/ /"calendar/ 



SEARCH EXPRESSION: 



A REGULAR EXPRESSION IMMEDIATELY FOLLOWING A qedx REQUEST 
(/abc/ IN THESE EXAMPLES) 

s/abc/xyz/ 

1 ,25s/abc// 

/abc/ 



REPLACE EXPRESSION: 



1 THE SECOND CHARACTER STRING IN A SUBSTITUTE REQUEST. (/abc/ IN 
THESE EXAMPLES) 

s/old/abc/ 

1 ,5s/old/abc/ 
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SPECIAL SYMBOLS 



/ (RIGHT SLANT -OR- SLASH) 



11 DELIMITS A REGULAR EXPRESSION 

/abc/ 

/"character/ 
/ters.»$/ 




USAGE 1> AS PART OF AN ADDRESS IN A qedx REQUEST 



D ADDRESSES THE CURRENT LINE 
1,.cl 
.,49p 



USAGE 20 AS A CHARACTER IN A SEARCH EXPRESSION 




MATCHES ANY CHARACTER 

/a.c/ MATCHES: 



aac 
abc 
azo 
a c 
. . .etc 



SPECIAL SYMBOLS 



• « (ASTERISK) 



a HAS SPECIAL MEANING ONLY IN A SEARCH EXPRESSION 



B MEANS ANY NUMBER (INCLUDING NONE) OF THE PRECEDING CHARACTER 



/ab*c/ MATCHES: ac 

abc 



abbe 
abbbc 
. . .etc 



/a.*c/ MATCHES: 



ac 
axe 
axyzc 
. . .etc 





USAGE 1:\ AS PART OF AN ADDRESS IN A qedx REQUEST 



S ADDRESSES THE LAST LINE OF THE USER'S BUFFER 

1,$p 
$d 



USAGE 2: /AS THE LAST CHARACTER OF A SEARCH EXPRESSION 




D MATCHES THE END OF A LINE (I.E., THE IMAGINARY CHARACTER 
FOLLOWING THE LAST CHARACTER OF A LINE) 

/calendar$/ MATCHES: calendar 

IF "calendar" ENDS A LINE 
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SPECIAL SYMBOLS 



(CIRCUMFLEX) 




D HAS SPECIAL MEANING ONLY AS THE FIRST CHARACTER OF A SEARCH 
EXPRESSION 



Q MATCHES THE BEGINNING OF A LINE (I.E. AN IMAGINARY CHARACTER 
PRECEDING THE FIRST CHARACTER ON A LINE) 

/''calendar/ MATCHES: calendar 

IF "calendar" BEGINS A LINE 




D HAS SPECIAL MEANING ONLY IN THE -REPLACE EXPRESSION OF A 
SUBSTITUTE REQUEST 



D EACH & IS REPLACED BY THE STRING WHICH MATCHED THE REGULAR 
EXPRESSION IN THE SEARCH EXPRESSION 



s/camp/&ing/ SAME AS: s/camp/camping/ 



s/junk/*»&"/ SAME AS: s/ junk/" junk"/ 



s/ab/&&&/ 



SAME AS: s/ab/ababab/ 



s/a .c/&def/ 



SAME AS: 



s/aac/aacdef / 
s/abc/abcdef/ 
s/azc/a2cdef/ 
s/a c/a cdef/ 

• . • 6 ^C 
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SPECIAL SYMBOLS 



// (DOUBLE RIGHT SLANT - OR - SLASH SLASH) 



B USAGE 1:) AS THE REPLACE EXPRESSION OF A SUBSTITUTE REQUEST 



D THE REPLACE EXPRESSION IS THE NULL STRING (A MEANS OF 
DELETING EXISTING CHARACTER STRINGS) 

s/abc// 




USAGE 2:\AS A SEARCH EXPRESSION 



D qedx REMEMBERS THE LAST SEARCH EXPRESSION DEFINED BY THE 
USER 



D // STANDS FOR THE LAST SEARCH EXPRESSION DEFINED 



/a.c/ 

s//xyz/ 

// 



SAME AS 



/a.c/ 

s/a .c/xyz/ 
/a.c/ 



\c (LEFT SLANT C -OR- BACKSLASH C) 



0 THE SEQUENCE \c IS A qedx ESCAPE SEQUENCE THAT CAUSES THE 
CHARACTER THAT FOLLOWS TO BE INTERPRETED AS A LITERAL 



0 SUPPRESSES (ESCAPES) THE SPECIAL MEANING OF qedx SPECIAL 
SYMBOLS 

/a\c.b/ 

s/\e^echpplex/ "echoplex/ 
s/abc/\c&def/ 
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EXAMPLES 



• INTERPRET THE FOLLOWING qedx REQUESTS: 

1 ,$s/a. . .b// 
1 ,$s/a. . .b/&&/ 
1 ,$s/a.*b/xy2/ 
1 ,$s/a. .*b/xy2/ 
1 ,$s/a.\c.«b/xy2/ 
1 ,$s/a. .\c*b/xyz/. 
1 ,$s/"a. . .b// 

• I a • • • / / 

1 ,$3/ ./a/ 

1,$s/./U/ 

1,$s/.»/&&/ 

1 ,$s/'^a«b»c»d/abcd/ 

1 ,$s/"a.»b.»c.»d/abcd/ 

1,$s/^ »// 

1,$s/'^ •/ ■&/ 

1 ,$8/'^. $/&&&/ 
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ADDRESSING 



• qedx REQUEST MAY TAKE ONE OF THREE GENERAL FORMS 
I <re(}uest> 

0 ADR<request> 

Q ADR,ADR<request> 

• ADDRESSES MAY TAKE ONE OF THREE GENERAL FORMS 

Q ABSOLUTE LINE NUMBERS 
5cl 
$p 

10, 12s/abc/xyz/ 
3 

a RELATIVE LINE NUMBERS (RELATIVE TO "CURRENT LINE") 
.+4d 

-2,.p 

-2 ,+5s/abc/xyz/ 
$-4,$p 
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ADDRESSING 



1 CONTEXTUAL ADDRESSING 

i AN ADDRESS MAY BE A REGULAR EXPRESSION 

D A LINE CAN BE ADDRESSED BY MATCHING REGULAR EXPRESSIONS TO 
STRINGS IN THE LINE 

/abc/d 

/abc/»25p 

/abc/+2,25p 

/abc/+2,+25p 

/''abc/ ,/xy2/s/ab/acc/ 

-4,/x.2/p 

/"ab»c/+2,/x.2/-3s/boat /boating / 
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ADDITION At 'BUFFERS 



• THE USER'S INITIAL BUFFER (SCRATCH PAD) HAS A RESERVED NAME OF 
b(0) 



• USERS MAY DEFINE AN ARBITRARY NUMBER OF ADDITIONAL BUFFERS BY 
SIMPLY REFERRING TO TH£M BY SOME CHOSEN NAME 



BUFFER REQUESTS DESCRIPTION 



m(narae) MOVE: MOVE THE SPECIFIED LINE OR LINES IN THE 

CURRENT BUFFER TO A BUFFER HAVING THE SPECIFIED 
NAME 

\b(name) REPRESENTS THE CONTENTS OF THE SPECIFIED BUFFER 

b(narae) BUFFER: CHANGE BUFFERS. MAKE THE SPECIFIED 

BUFFER THE "CURRENT" BUFFER 

X STATUS: PRINT A SUMMARY OF THE STATUS OF ALL 

BUFFERS 



• CUT AND PASTE EXAMPLJ. MOVE LINES 14 THROUGH 17 IMMEDIATELY BELOW 
LINE 10 • 

14,17m(l) 
10a 

\b(1)\f 
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AREAS FOR ADDITIONAL STUDY 

• ADDITIONAL DOCUMENTATION OF qedx 

0 MPM COMMANDS AND ACTIVE FUNCTIONS (AG92) 
Q NEW USER'S GUIDE (AL40) 
fl help qedx 

m STUDY TOPICS 

D MULTIPLE REQUEST ON A LINE 
dp 

s/abc/xyz/p 
s/abc/xyz/w file_13 
\fw 
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AREAS FOR ADDItlQHAL STUDY 

fl ADDITIONAL qedx EDIT REQUESTS 

g (global) aM 

gp/xyz/ 

1 , lOgd/xyz/ 

10,26g=/xyz/ 

V (exclude) 

vp/xyz/ 
1,10vd/xyz/ 
1 , .vs/xyz/ 

n (nothing) 

5n 

" (comment) 

"This is a comment in a macro 



4-11 



F01 



AfiEAS FOR ADDiyi^HAL STUDY 



ADDRESSING USIHG INSTEAD OF 
ADR ;ADR<request> 
/abc/;+5ci 



D DELIMITERS OTHER THAN "/« 



D RESERVED BUFFERS: b(0), b(exec), b(args) 



D qedx MACRO FACILITY 



I BY TYPING THE FOLLOWING COMMAND LINE: 

qedx my_macro.qedx add 

THE FOLLOWING MACRO IS INVOKED WITH BUFFER b(args) 
CONTAINING THE ARGUMENT add 



my^macro.qedx 



r \b(args) .fortran 
1 ,$s/write.*)/print/ 
w 

q 
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TOPIC Y 



THE STORAGE SYSTEM 



Page 

Segments ..... 5-2 

Directories 5-6 

Storage System Control 5-8 

Storage System Hierarchy 5-10 

Pathname Conventions 5-13 
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• SYSTEM GOALS: 

I DECENTRALIZATION OF THE SYSTEM'S LOGICAL FILE SPACE 

II EASE OF USE 

• EFFECT ON STORAGE SYSTEM 

11 HIERARCHY OF DIRECTORIES 

II PATHNAME CONVENTION 

>udd>FED>LJones>tools>my_eciitor 

0 WORKING DIRECTORY CONCEPT 

change__wdir >udd>FED>LJones>tools 
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SEGMENTS 



0 




• SEGMENT 

I THE BASIC UNIT OF INFORMATION STORAGE 

II SOMETIMES REFERRED TO AS A FILE 

fl SEGMENTS RESIDE ON DISK PACKS (SECONDARY STORAGE) 

0 SIZE IS INTEGER NUMBER OF RECORDS (102M WORDS). 0,1,2,3... 

0 MAXIMUM SIZE IS 256 RECORDS (256K WORDS) 

• ALL SEGMENTS HAVE AT LEAST ONE GIVEN NAME (ENTRYNAME) 



home work 3 



add .pll 



start_up.ec 
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SEGMENTS 



• MUST DISTINGUISH BETWEEN THE CONTENTS OF A SEGMENT AND THE 
ATTRIBUTES OF A SEGMENT 

I THE CONTENTS OF A SEGMENT MAY BE: 
I DATA (EITHER RAW OR FORMATTED) 
I TEXT (USUALLY ASCII) 
I SOURCE OR OBJECT PROGRAM 
E EMPTY (ZERO LENGTH) 

D SOME ATTRIBUTES OF A SEGMENT ARE: 

0 THE NAME (S) OF THE SEGMENT (CALLED ENTRYNAME(S)) 

fl THE SEGMENTS UNIQUE IDENTIFIER (A UNIQUE, 36 BIT, INTERNALLY 
USED NAME) 

D THE AUTHOR (I.E., THE user__id OF THE CREATOR) 

0 THE LENGTH (IN BITS) OF THE SEGMENTS CONTENTS 

D THE BIT COUNT AUTHOR (I.E. THE user^id OF THE LAST PERSON 
TO MODIFY THE CONTENTS) 

1 THE ACCESS CONTROL LIST SPECIFYING WHO MAY ACCESS THE 
SEGMENT AND HOW THEY MAY ACCESS IT 

0 THE AMOUNT OF DISK SPACE (IN RECORDS) OCCUPIED BY THE 
SEGMENT 
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SEGMENTS 



D DATE AND TINE SEGMENT'S CONTENTS WERE LAST MODIFIED 

D DATE AND TIME THE SEGMENT'S ATTRIBUTES WERE LAST MODIFIED 



D DATE AND TIME SEGMENT'S CONTENTS WERE LAST DUMPED (I.E., 
COPIED TO TAPE BY THE MULTICS BACKUP PROCEDURES) 



D DATE AND TIME SEGMENT'S CONTENTS WERE LAST REFERENCED 
0 THE STATE OF THE SEGMENT'S COPY SWITCH 
0 THE STATE OF THE SEGMENT'S SAFETY SWITCH 



• THE CONTENTS OF A SEGMENT MAY BE READ BY USING THE print COMMAND 
OR qedx's "r" AND "p" REQUESTS 



THE ATTRIBUTES OF A SEGMENT MAY BE OBTAINED BY USING THE list OR 
THE status COMMAND 



• THE ACCESSING OF A SEGMENT'S CONTENTS AND A SEGMENT'S ATTRIBUTES 
ARE INDEPENDENTLY CONTROLLED BY THE MULTICS ACCESS CONTROL 
MECHANISM 
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SEGMENTS 



CONTENTS 



ATTRIBUTES 



ATTRIBUTE VALUE 



The Multics System i 
s a general purpose 
computer system deve 
loped by the\012Mass 
achusetts Institute 
of Technology and H 
oneywell Infor-\012 
mation Systems. Int 
reduced to commercia 
1 markets\012in Janu 
ary 1973, Multics w 
as then the result o 
f more than 7 years 
of research. \012 



names : 
author : 
access: 

bit count: 
records used: 
date modified: 
date dumped: 
date used: 



home_work_3 i hw3 
May. FED. a 

r w May. FED.* 

r w * .SysDaemon . * 

il9698 
2 

03/21/77 103^. M mst 
03/21/77 1051 .0 mst 
09/07/77 0818.9 mst 



• MAY HAVE UP TO 19 MILLION SEGMENTS IN A SYSTEM (512 MSU » 38,000 
SEGMENTS) 



ff( — &f?tf)Wi^AT-i9«^:::^^ CONTAIN THE NAMES, 

ADDRESSES AND ATTRIBUTES OF OTHETsEGMIINT^X 



D THESE SEGMENTS SERVE AS A CATALOG OF THE OTHER SEGMENTS 



11 THESE "CATALOG" SEGMENTSXARE CALLED DIRECTORIES 
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DIRECTORIES 



DIRECTORY 

D A SEGMENT CONTAINING THE NAMES, ADDRESSES AND ATTRIBUTES OF 
OTHER SEGMENTS AND/OR OTHER STORAGE SYSTEM ENTITIES 



D A MEANS OF ORGANIZING (CATALOGING) SEGMENTS AND/OR OTHER 
STORAGE SYSTEM ENTITIES 

0 SPECIFICALLY, A DIRECTORY MAY BE A CATALOG OF THE FOLLOWING 
STORAGE SYSTEM ENTITIES: 

0 FILES 

0 SEGMENTS (SINGLE SEGMENT FILES) 
0 MULTISEGMENT FILES 

D OTHER DIRECTORIES 

0 LINKS 

0 MAY BE EMPTY 

ALL DIRECTORIES HAVE AT LEAST ONE GIVEN NAME (ENTRYNAME) 

udd jo>^ J^^^^ Jn^^.:^-^ 

F01 

Dlr_A 

system_library unbundled 
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DIRECTORIES 
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STORAGE SYSTEM CONTROL 

' • MAY HAVE UP TO 19 MILLION SEGMENTS IN A SYSTEM, SOMEONE MUST 
CONTROL: 

D THE ALLOCATION OF DISK SPACE TO USERS (WHO GETS WHAT?) 
fl THE CREATION AND USE OF SEGMENTS (I'VE GOT A SECRET!) 
D THE SHARING OF SEGMENTS (YOU MAY USE MINE TOO!) 

• HIERARCHY OF ADMINISTRATORS 

0 THE SYSTEM ADMINISTRATOR 
a PROJECT ADMINISTRATORS 

1 USERS 
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SfORAGE SYSTEM CONTROL 



SYSTEM 
ADMINISTRATOR 



ProjA PROJECT 
ADMINISTRATOR 



F01 PROJECT 
ADMINISTRATOR 



USER 




USER 




USER 


May 




Kerr 




Abel 



USER 




USER 




USER 




USER 


S_01 




S_02 




S_03 




S_04 
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STORAGE SYSTEM HIERARCHY 



• NEED TO PARTITION THE FAMILIES OF DIRECTORIES AND SEGMENTS INTO 
MANAGEABLE COMMUNITIES 



• STORAGE SYSTEM IS MAPPED ONTO ADMINISTRATION HIERARCHY 



ROOT ' 
DIRECTORY 


1 


1 


USER D] 
DIRE( 


[RECTORY 

:tory 



ProjA 
DIRECTORY 



F01 
DIRECTORY 



May 




Kerr 




Abel 


DIR 




DIR 




DIR 



S 01 




S 02 




S 03 




S 04 


DTR 




dIr 




DTR 




DiR 
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STORAGE SYSTEM HIERARCHY 



THE STORAGE HIERARCHY IS ANALOGOUS IN FORM TO AN INVERTED TREE 



THE USER DIRECTORY DIRECTORY (udd) EMANATES FROM THE ROOT 
DIRECTORY 



ALL PROJECT DIRECTORIES EMANATE FROM THE USER DIRECTQRY 
DIRECTORY (udd) 



• ALL USER DIRECTORIES EMANATE FROM THEIR RESPECTIVE PROJECT 
DIRECTORIES 



• USERS MAY ARBITRARILY CREATE DIRECTORIES SUBORDINATE TO THEIR OWN 
USER DIRECTORY - UP TO A MAXIMUM DIRECTORY DE PTH OF 16. (TOP TO 
BOTTOM) " 



• A SEGMENT WHOSE POSITION IS IMMEDIATELY BELOW A GIVEN DIRECTORY IS 
SAID TO BE: 



"In the directory" 
- OR - 
"Under the directory" 
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STORAGE SYSTEM HIERARCHY 



> 



system__library_ 
standard 



user_dir dir 
(udd)"" 



system_library^ 
unbundled 





May 




Kerr 




Abel 

















seg_1^ ^Princ^ 


hw^dir 


^dd.pl 
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PATHNAME CONVENTIONS 



ABSOLUTE PATHNAME 

B A PATHNAME THAT UNIQUELY IDENTIFIES A SEGMENT (OR DIRECTORY) BY 
ITS ABSOLUTE POSITION IN THE DIRECTORY HIERARCHY 

D FORMED BY CONCATENATING A SEGMENT »S (OR DIRECTORY'S) ENTRYNAME 
WITH ALL SUPERIOR DIRECTORIES LEADING BACK TO THE ROOT 

>udd>F01 >Student__01 >add .pi 1 

D THE > (GREATER-THAN) CHARACTER IS USED TO SEPARATE THE 
ENTR^MES IN A PATHNAME , 

fl AN ABSOLUTE PATHNAME ALWAYS BEGINS WITH > (GREATER-THAN) 

0 DIRECTORY ABSOLUTE PATHNAMES 
>udd>ProjA 
>udd>F01>Student_01 
>udd>F01>Student_01>hw__dir 

0 SEGMENT ABSOLUTE PATHNAMES 

>udd>F01 >Student__01 >add .pll 
>udd>F01>Student_01>hw_dir>lesson_2 
>udd>ProjA>Kerr>start up.ec 
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PATHHAME CONVENTIONS 



• NOTICE THAT AN ABSOLUTE PATHNAME SUCH AS 
>udcl>ProjA>Kerr>start__up.ec 

IDENTIFIES: 

fl THE ENTRYNANE OF THE SEGMENT ( start-up. ec) 
D THE Person^id OF THE "OWNER" (Kerr) 
B THE Projeot^id OF THE "OWNER" (ProjA) 
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PATHHAME CONVENTIONS 



HOME DIRECTORY ( WHERE THE HEART IS) 



E THE DIRECTORY IN WHICH THE USER "FINDS" HIMSELF IMMEDIATELY 
AFTER LOG IN 



D THE INITIAL WORKING DIRECTORY 



fl THE Person id AND Project id GIVEN AT LOG IN DETERMINE THE HCHE 
DIRECTORY 

0 IS GENERALLY: >udd>Project_id>Person__id 

>udd>F01>Student_02 
>udd>ProjA>Abel 

WORKING DIRECTORY (WHERE THE ACTION IS) 



e THE DIRECTORY IN WHICH THE USER IS CURRENTLY WORKING (THE 
INITIAL WORKING DIRECTORY IS THE HOME DIRECTORY) 



D THE USER MAY CHANGE HIS WORKING DIRECTORY, AS DESIRED, TO ANY 
OTHER DIRECTORY IN THE STORAGE SYSTEM 



D COMMANDS SUCH AS list AND qedx»s "r" and "w" WILL OPERATE ON 
THE SEGMENTS IN THE USER»S WORKING DIRECTORY 
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PATHMAHE CONVEIITIONS 



RELATIVE PATHNAME 

0 A PATHNAME THAT UNIQUELY IDENTIFIES A SEGMENT (OR DIRECTORY) BY 
ITS POSITION RELATIVE TO THE USER'S WORKING DIRECTORY 

0 NEVER BEGINS WITH ^ (GREATER-THAN ) 
D DIRECTORY RELATIVE PATHNAME 



ProjA 
udd>ProjA 

Student_01 
F01>Student__01 

hw_dir 

Student_01>hw dir 
F01>Student OT>hw dir 



add. pi 1 

Student_01 >add .pl1 

lesson__2 
hw__dir>les5on_2 

start_up.ec 

Kerr>start_up.ec 

ProjA>Kerr>start_up.ec 



THE WORKING DIRECTORY CONCEPT IS SIMPLY A CONVENIENCE THAT ALLOWS 
THE USER TO TYPE RELATIVE PATHNAMES INSTEAD OF THE LONGER ABSOLUTE 
PATHNAMES 



D SEGMENT RELATIVE PATHNAMES 
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PATHNAME CONVENTIONS 



• ENTRYNAMES (PATHNAME MEMBER) 
a 1 TO 32 CHARACTERS LONG 

D SHOULD JOT INCLUDE ><« = ?%$»»() SPACE OR TAB 

fl _ (UNDERSCORE) 

0 SIMULATES A SPACE fOR READABILITY 
Bobs_orig__eclitor .pll 

D . (PERIOD) 

D SEPARATES COMPONENTS OF AN ENTRYNAME 



D LAST COMPONENT OF AN ENTRYNAME IS CALLED THE SUFFIX 

D ENTRYNAMES MUST BE UNIQUE WITHIN A DIRECTORY 

I SEGMENTS AND DIRECTORIES MAY HAVE MORE THAN ONE ENTRYNAME 



ms tester .old .fortran 



test. 14 may. new compiler 



homework dir 



t . 14m. nc 



hw dir 



may comp 



hw 
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PATHNAHE COHVEtltlONS 



• NOTICE THAT IN THE SIMPLEST CASE (WHERE A USER LOGS IN, CREATES 
AND EDITS HIS HOME DIRECTORY FILES) NO KNOWLEDGE OF THE HIERARCHY 
IS REQUIRED 
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TOPIC VI 



STORAGE SYSTEM COMMANDS 



Page 

Directory Manipulation Commands ........ 6-1 

Segment Manipulation Commands 6-3 

Storage System Examples . 6-14 
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DIRECTORY MANIPULATION COMMANDS 



/ 



• print w^ir, pwd (Wi^ERE AM I?) 



B PRINTS THE PATHNAME OF THE CURRENT WORKING DIRECTORY 

D USAGE: print^wdir 
pwd 



• change^w^ir , ^wd (MOV^ OUT!) 

0 CHANGES TifE USER^S WORKING DIRECTORY 

Q USAGE: change_wdir (path) 
cwd dir_A 

cwd >udd>Fai>Student_08>dir_A 
cwd 
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DIRECTOBY MANIPULATIOH COMMANDS 



create^dlr, cd (UF^O 16 DEEP) 



0 CREATES AN EMPTY DIRECTORY 

0 DOES NOT CHANGE THE USER'S WORKING DIRECTORY 

D USAGE: create^dir paths {-control^args} 
cd dir^A 

cd >udd>F01>Student_09>myd 



delete_dtr, dd (DO YOU REALLY...?) 

V 

0 DELETEsNdESTROYS) SPECIFIED DIRECTORIES (AND ALL SUBORDINATE 
DIRECTORIES AND SEGMENTS) 



USAGE: delete_dir paths 
dd programs 

dd >udd>F01>Student 01>programs 
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SEGMENT MANIPULATION COMMANDS 



• create ,_cr (SELDOM NEEDED) 

B CREATES AN EMPTY SEGMENT 

Q USAGE: create paths 
cr seg_1 

cr seg_1 seg__2 A B 

cr >udcl>F01>Student_07>adcl.pl1 

• delete, dl i 

0 DELETES (DESTROYS) SPECIFIED SEGMENTS 

S USAGE: delete paths 

dl seg 1 add.pH 
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SEGMENT MANIPULATtOH COMHANDS 



0 COPIES A SPECIFIED SEGMENT TO A NEW POSITION IN THE HIERARCHY 



D DOES NOT COPY A SEGMENT »S "ADD NAMES" UNLESS REQUESTED 

II USAGE: copy path1 {path2} { -control_args} 

cp >udd>FED>LJones>add >udd>FED>LJones>exp>add 

cp >udd>FED>LJones>add add. old 

cp >udd>FED>LJones>add 

cp >udd>FED>LJones>add -name 




0 MOVES A SPECIFIED SEGMENT (TO INCLUDE ACL AND ADD NAMES) TO A 
NEW POSITION IN THE HIERARCHY 

0 USAGE: move pathi {path2} {-control_args} 

move >udd>FED>Kerr>dev>x_sort >udd>FED>Kerr>tools>sort 
move >udd>FED>Kerr>dev>x__sort sort 
move >udd>FED>Kerr>dev>x sort 



copy, cp 
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SEGMENT MAHIPULATIOii COMMANDS 

m acl(r_name, an (ALIAS) /r^f'^ 

a ADDS ALTERNATE NAME(S) TO A SEGMENT OR DIRECTORY 
Q SUCH NAMES ARE CALLED "ADD NAMES" 
D USAGE: add_name path names 

an >udd>F01>Student 01>seg l.new sin 



delete_name, dn ^ 



Q DELETES NAME(S) FROM SEGMENTS AND DIRECTORIES 

B USAGE: delete_name paths 
dn seg_1 .new sin 
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SEGMENT HAHlPULATiOH COMMANDS 



rename/ rn , 

0 REPLACES A SEGMENT OR DIRECTORY NAME WITH ANOTHER 



0 USAGE: rename pathj[ name^* • •pathn namen 
rn s_1.n seg_1.new 



• list/; Is / (ROLL CALL) 



Q RETURNS ATTRIBUTE INFORMATION ABOUT STORAGE SYSTEM ENTITIES 
^\ BY DEFAULT ONLY SEGMENTS ARE LISTED -'^^^^^^^ 



D USAGE: list {entrynames} {-control_args} 
Is 

Is add.pll seg_1 




Is -all -sort name 
list -date time contents modified 
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SEGMENT MANIPULAnON COMMANDS 



statu/, St (WHO, WHAT, WH£R£, AND WHEN) 



Q RETURNS STATUS INFORMATION ABOUT SEGMENTS AND DIR ECTORIES . 
INCLUDING 



1 DATE AND TIME MODIFIED, USED AND DUMPED 

D User^id OF AUTHOR AND User^id OF LAST MODIFIER 

D SIZE, ACCESS CLASS, ACCESS MODES, RING BRACKETS 

fl USAGE: - status paths {-control_args} 
- st seg_1 
^ st seg_1 -length 
st seg 2 -author -date 



• print, pr C<. .LET'S SEE WHAT YOU LOOK LIKE) 

D PRINTS THE CONTENT S OF A SEGMENT 

\ USAGE: print path {begin} {end} 
pr seg_1 
pr add.pll 150 
pr prince 40 120 
pr >udd>F01>Student_08>add.pl1 
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SEGMENT MANIPULATION COMMANDS 



• compose, comp (PLASTIC SURGERY) 



D FORMATS TEXT SEGMENTS INTO MANUSCRIPT FORM 



fl SEGMENTS MUST HAVE SUFFIX OF compinAND NORMALLY CONTAIN 
CONTROL STATEMENTS WHICH DRIVE THE FORMATTING 



B IF OUTPUT IS DIRECTED TO A SEGMENT, THE ENTRYNAME IS GIVEN A 
SUFFIX OF compout 



Q THIS COMMAND REPLACES THE runoff COMMAND, AND PROVIDES A 
SUPERSET OF THE runoff CAPABILITIES TO INCLUDE INLINE ARTWORK* 

Q USAGE: compose paths {-control_args} 
comp thesis .compin 

comp thesis .compin -in 10 -of -dv dtcSOOs -pass 2 
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SEGMENT MANIPULATION COMMANDS 



• dprint, dp (START THE PRESSES!) 



B QUEUES A REQUEST TO PRINT THE CONTENTS OF A SPECIFIED SEGMENT 
ON THE LINE PRINTER 



D THE USER MAY SPECIFY ONE OF THREE PRIORITY QUEUES (QUEUE »»3** IS 
ASSUMED - LOWEST PRIORITY, LOWEST COST) 



0 THE PRINTING IS DONE BY ONE OF THE SYSTEM DAEMONS (A SERVICE 
PROCESS) 

fl USAGE: dprint {-control__argsi {paths} 
dp seg_1 

dp -cp 4 -ds MD_104 seg__1 
dp seg__1 -cp 3 seg_2 -ds Bldg_4 seg_3 
dp -he "Tom Smith" -notify seg_1 add.pll 
dp -delete -q 1 Prince 

D DEFAULTS: -cp 1, -ds Project_id, -he Person__id, -q 3 
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SEGMENT MANIPULAtiOH COMMANDS 



dpunch, dpn (START THE PUNCHES!) 

0 QUEUES A REQUEST TO PUNCH THE CONTENTS OF A SPECIFIED SEGMENT 
ON THE CARD PUNCH 

Q CONTROL ARGUMENTS AND DEFAULTS ARE THE SAME AS THE dprint 
COMMAND'S 

fl USAGE: dpunch {-control_args} {paths} 

dpn -he Larry -ds "Room 21" prince 



0 PRINTS INFORMATION ABOUT OUTSTANDING dprint AND dpunch REQUESTS 
IN A SPECIFIED QUEUE (DEFAULT IS -queue 3) 

0 USAGE: list_daemon__requests {-control^args} 
Idr 



list daemon request^, Idr 




Idr -queue 1 
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SEGMENT MANIPULATION COMMANDS 



cancel_daemon_request , cdr 




D CANCELS A dprint OR dpunch REQUEST IN THE QUEUE SPECIFIED 
(DEFAULT IS -queue 3) 

Q USAGE: cancel_daeinon_request request_id {-control_args} 



walk__subtree, ws (AND DON'T COME BACK UNTIL YOU ARE THROUGH!) 

Q EXECUTES ANY SUPPLIED COMMAND LINE IN A SPECIFIED DIRECTORY, 
AND ALL INFERIOR DIRECTORIES 

11 A LIBRARY MANAGEMENT TOOL 

il USAGE: walk__subtree path "command_line" {-control args} 



cdr prince 



cdr -id 202008 



cdr -entry prince 



ws >udd>F01 "list -all" 



ws -wd "sa ** r *.*.*" 



ws ^>w(^ "da LJones. 



«.«»» -bottom up 
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STORAGE SYSTEM EXAMPLES 



NOTE: THE READY MESSAGE IS NOT SHOWN IN THE FOLLOWING TERMINAL 
SESSION 



W DIR 



Student 01 



! pwd 

>udd>F01>Student^01 


(print wdir) 
(outpu*^) 


! (Is 

^^.-"^^i rectory empty. 


(list) 
(output) 


! qx 
! a 

1 add: proc 
! end add 
! \f 

! w add.pH 
1 q 


(qedx) 

(append mode) 

(text) 

(text) 

(edit mode) 

(write) 

(quit) 


! cr seg^l Prince 


(create) 


! cd hw dir 


(create dir) 



W DIR 
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STORAGE SYSTEM EXAMPLES 



! pwd 

>udd>F01>Student__01 

! Is 

Segments s 3, Lengths s 1, 

r w 0 Prince 
r w 0 seg_1 
r w 1 add. pi 1 

I Is -sort name -all 

Segments = 3, Lengths = 1. 

r w 1 add. pi 1 
r w 0 seg_1 
r w 0 Prince 

Directories s 1 . 

sma hw_dir 

! cr hw__dir>lesson_1 .math 

I cwd hw_dir 

! pwd 

>udd>F01>Student_01>hw__dir 

! cr lesson_12.eng 



(print_wdir) 
(output) 

(list) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(list) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(create) 

(change_wdir) 

(print_wdir) 
(output) 

(create) 
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STORAGE SYSTEM EXAMPLES 



Student 01 



W DXR 
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STORAGE SYSTEM EXAMPLES 



Is lesson_12.eng 
Segments = 1, Lengths = 0. 
r w 0 lesson_12.eng 
Is -sort name -reverse(-clti 
Segments s 2, Lengths s 0. 



0 lesson_12,eng 
0 lesson 1 .math 



09/13/77 0849.2 r w 
09/13/77 0849.1 r w 

cwd 

pwd 

>udd>F01>Student 01 



dp add. pi 1 

1 request signalled, 22 already in queue 3 
ws -wd "Is -brief" 




>udd>F01>Student_01 

Segments s 3, Lengths s 1. 

Prince 

seg_l 

add.pll 

>udd>F01>Student_01>hw_dir 

Segments = 2, Lengths s 0. 

lesson_12.eng 
lesson 1 .math 



( list) 
output) 
output) 
output) 
output) 

list) 

output) 

output) 

output) 

output) 

output) 

change_wdir) 

print_wdir) 
output) 



dprint) 
output) 

walk__subtree) 

output) 

output) 

output) 

output) 

output) 

output) 

output) 

output) 

output) 

output) 

output) 

output) 

output) 

output) 

output) 



YOU ARE NOW READY FOR WORKSHOP 
#3 
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TOPIC VII 



THE COMHAND LANGUAGE 



Page 

What is a Command ...... ..... 7-1 

Command Arguments ....... .... 7-4 

Common Control Arguments ... ..... 7-6 

Star Convention . 7-7 

Subsystems 7-10 
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WHAT IS A CQMHAHD 

• COMMAND PROCEDURE 

i A PROGRAM - USUALLY WRITTEN BY A SYSTEMS PROGRAMMER 

11 RESIDES IN ONE OF THE SYSTEM'S LIBRARIES 

II EXECUTED BY TYPING ITS NAME 

II DESIGNED TO 

0 PERFORM EXPECTED TASK 

D ACCEPT AN ARBITRARY NUMBER OF ARGUMENTS 

Q REPORT TYPING ERRORS 

S HANDLE OTHER USER ERRORS 
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WHAT IS A COMMAND 

• COMMAND 

D THE CHARACTER STRING TYPED AT THE TERMINAL TO INVOKE A SPECIFIC 
COMMAND PROCEDURE 

Q EXAMPLES: 

I THE COMMAND PROCEDURE accept^messages IS INVOKED BY TYPING 
THE COMMANDS: 

accept_messages 

am 

D THE COMMAND PROCEDURE print IS INVOKED BY TYPING THE 
COMMANDS : 

print seg__1 

pr treasure_hunt 
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WHAT IS A COMHAND 



COMMAND LINE 

3 A LINE TYPED AT THE TERMINAL WHEN AT MULTICS COMMAND LEVEL 

Q NAY BE ONE COMMAND 

accept_messages 
am 

print seg_1 

a MAY BE A MISTYPED COMMAND 
primt seg_1 

B MAY BE MORE THAN ONE COMMAND SEPARATED BY SEMI-COLONS 
accept_messages ; pr seg__1 
am; print start_up.ec; who 

0 MAY BE NULL (I.E., JUST A LINEFEED) ^ /^-^' O 

D FREE FORMAT ACCEPTED (EXTRA SPACES ARE IGNORED) 

list -all; sm LJones.FED TECO is ready! 

print add.pH 
am;pm;who 
am ;pm; who ;; 
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COMMAND ARGUMENTS 



• ARGUMENTS 



0 A SERIES OF CHARACTER STRINGS THAT FOLLOW A COMMAND 



# PATHNAME ARGUMENTS 



E THE NAMES OF SEGMENTS OR DIRECTORIES UPON WHICH THE COMMAND IS 
TO ACT 



cwd >udd>F01>Student_01 
print seg_l 



• CONTROL ARGUMENTS 

B ARGUMENTS THAT MODIFY THE MANNER IN WHICH THE COMMAND PERFORMS 
ITS TASK 

D ALWAYS START WITH A - (MINUS) 
list -segment 
list -directory 
list -all 

list seg 1 -date time used 
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COMMAND ARGUMENTS 



* ARGUMENTS OF CONTROL ARGUMENTS 

dprint -copy 2 -ds MS__102 add. pi 1 
dp -cp 2 -ds '"MS 102" add.pll 
set__tty -modes crecho 
memo -time Sam WAKE UP! 



• OTHER ARGUMENTS 

sm Student_04 .F01 Going to lunch? 
print seg_2 15 40 
login TSmith 



# NO ARGUMENTS 



^ ^ print_wdir 

defer__messages 



• DEFAULT ARGUMENTS (HURRAH FOR DEFAULTS!) 

^n-j- — c|mn^_wdir {Home Directory} 
^ print seg_2 {first last} 
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COMMON CONTROL ARGUMENTS 



LONG FORM 



SHORT FORM 



USUAL MEANING 



-all 
•brief 

•copy n 

•directory 

•long 

•optimize 

•print 
-queue n 

-segment 

-table 

-time {dt} 

-totals 



-a 
-bf 

-cp n 

-dr 

* 

-Ig 

-ot 

-pr 
-q n 

-sm 

-tb 

-tm {dt} 
-tt 



OPERATE ON ALL TYPES OR ALL ENTRIES 

SHORTEN THE VERBOSITY AND/OR 
CONTENTS OF RESPONSE 

CREATE n COPIES 
OPERATE ON DIRECTORIES 



INCREASE THE VERBOSITY AND/OR 
CONTENTS OF RESPONSE 



OPTIMIZE GENERATED 
COMPILERS) 



CODE (FOR 



PRINT A STATUS OR SUMMARY REPORT 
USE PRIORITY QUEUE n 



OPERATE ON SEGMENTS, OR SEND OUTPUT 
TO A SEGMENT 



GENERATE A 
COMPILERS) 



SYMBOL TABLE (FOR 



DELAY UNTIL THE SPECIFIED TIME, OR 
GENERATE TIMING STATISTICS 

PRINT TOTALS 
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STAR COHVENTIOS 



• STAR CONVENTION 

B A SHORTHAND NOTATION ACCEPTED BY MANY COMMANDS USED TO SPECIFY 
A GROUP OF SEGMENTS OR DIRECTORIES 

0 / MATCHES ANY SINGLE C OMPONENT OF AN ENTRYNAME 

\ MATCHES ANl^ GROUP OF n nMPnNFMT5; TW AN ENTRYNAME 

D ^MATCHES ANY CHARACTER IN A COMPONENT OF AN ENTRYNAME 

• ASSUME SOME DIRECTORY CONTAINS THE FOLLOWING SEGMENTS: 



• EXAMPLES USING THE list COMMAND (THE list HEADER IS NOT SHOWN) 



a .fortran 
ad . fortran 

add 

add.pH 
new 

new. a .fortran 



seg__1 .pl1 
seg 1 .new 



seg__1 .new.cobol 
seg_1 .old 
seg_1 .old .pll 
seg 1 .old. test .pll 



list seg_1.pl1 seg_1.new seg 1.old 



rw 1 seg_1.pl1 
rw 2 seg_1.new 
rw 1 seg_1.old 
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STAR CONVENTION 



list seg_1 .* 

rw 1 seg_1.pl1 

rw 2 seg__1 .new 

rw 1 seg l.old 



list segj.».» 

rw 1 seg__1 .new.cobol 
rw 2 seg l.old.pll 



list new.** 




rw 1 new 

rw 1 new. a . f ortran 



list *.pl1 



rw 1 add.pll 
rw 1 seg_1.pl1 



list **.pll 



rw 1 add.pll 

rw 1 seg_1 .pll 

rw 2 seg_1 .old .pll 

rw 1 seg_1 .old. test .pll 



list *.*.*.* 

rw 1 seg_1 .old .test .pll 



list a* ' /^"^ , . 

rw 1 add ■ 



F01 



STAR COHVENtiON 



list s*.*.pl1 

rw 2 seg_1 .old.pll 



list s*.**.p* 

rw 

rw ' 
rw 



list ??? 

rw 1 add 
rw 1 new 



1 seg_1.pl1 

2 seg_1 .old.pll 
1 seg_1 .old .test .pll 



list a?.» 

rw 1 ad.fortran 



list a?«.* 

rw 1 ad.fortran 
rw 1 add.pH 



list ad«.»» 

rw 1 add 

rw 1 add. pi 1 

rw 1 ad.fortran 



list »* 

<all segments> 



SUBSYSTEMS 



• SUBSYSTEM 

0 A COLLECTION OF PROGRAMS THAT PROVIDE A SPECIAL ENVIRONMENT FOR 
SOME PARTICULAR PURPOSE 

0 EDITING 

edm 
qedx 

D CALCULATION 

calc 

II DEBUGGING 

probe 
debug 

D A USER ENTERS A SUBSYSTEM BY COMMAND AND EXITS THE SUBSYSTEM BY 
REQUEST 

0 TYPED LINES ARE INTERPRETED BY THE SUBSYSTEM, NOT BY THE 
MULTICS COMMAND PROCESSOR; THEREFORE, THEY ARE NOT COMMAND 
LINES 

Q THE SUBSYSTEM MAY PERFORM ITS OWN REQUEST PROCESSING, FILE 
HANDLING, AND ACCOUNTING 
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SUBSYSTEMS 



• REQUEST LINE FLOW 



TYPED LINE 

i 

FRONT-END PROCESSOR 

1 

SUBSYSTEM 

i 

EXECUTION 



• COMMAND LEVEL 



D THE PROCESS STATE IN WHICH TYPED LINES ARE INTERPRETED BY THE 
MULTICS COMMAND PROCESSOR 



0 TYPED LINES ARE REFERRED TO AS COMMAND LINES 



• SUBSYSTEM LEVEL 



B THE PROCESS STATE IN WHICH TYPED LINES ARE INTERPRETED BY THE 
SUBSYSTEM 



B TYPED LINES ARE REFERRED TO AS REQUEST LINES 
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TOPIC VIII 



EXEC COM BASICS 



Page 

What is an Exec_com ; 8-1 

Exec com Mechanism ....... 8-2 

Star"E up Exec_coms 8-4 
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WHAT IS AN EXEC COM 




EXEC COM 



E A SEGMENT THAT CONTAINS A SERIES OF COMMAND LINES 

fl MAY BE CREATED USING A TEXT EDITOR 

I SEGMENT NAME MUST HAVE A SUFFIX OF ec 
A.ec 

print.ec 
start__up.ec 



0 THE COMMAND LINES ARE EXECUTED SEQUENTIALLY, AS A SET, BY USING 
THE exec com COMMAND 
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EXEC COM MECHANISM 



exec /com , ec. / 



D EXECUTES THE COMMAND LINES CONTAINED IN AN EXEC COM SEGMENT 



D COMMAND LINES ARE PRINTED ON THE USER'S TERMINAL AS THEY ARE 
EXECUTED 



1 USAGE: exec^com path 
ec A.ec 
ec print. ec 
ec start_up.ec 



EXEC^COM LINE FLOW 

EXEC COM LINES 



i 



COMMAND PROCESSOR 



i 



EXECUTION 
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EXEC COM HECHANXSM 



• EXAMPLE: LET THE SEGMENT print.ec CONTAIN THE FOLLOWING TEXT: 

print. ec 



cwd >udd>F01>Student__07 
Is 

pr seg_1 
logout 



D TYPING THE ONE COMMAND 
ec print .ec 

HAS THE SAME EFFECT AS TYPING THE FOUR COMMANDS ABOVE 
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START UP EXEC COMS 



START UP EXEC COM 



0 HAS THE NAME start-up. ec 



0 LOCATED IN USER'S HOME DIRECTORY 



THE COMMAND LINES CONTAINED WITHIN ARE AUTOMATICALLY EXECUTED 
FOR THE USER AT LOGIN 



S CAN ALSO BE INVOKED MANUALLY 
ec start_up.ec 




COMM ON USAGE , 




fl SET-UP USER'S ENVIRONMENT 



D CHECK ON EVENTS SINCE LAST LOGIN 



D PERFORM ANY DESIRED TASKS AT LOGIN 
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START UP EXEC COMS 



EXAMPLE: LET THE SEGMENT start_up.ec CONTAIN THE FOLLOWING TEXT 



start-up .ec 




THESE TWO COMMANDS ARE AUTOMATICALLY EXECUTED FOR THE USER AT 
LOGIN 



NOTE: THE PRESENCE OF A start up.ec WILL SUPPRESS THE PRINTING OF 
THE SYSTEM'S MESSAGE OF THE DAY AT LOG IN 
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START UP EXEC COMS 

• print_motd, pmotd 

0 PRINTS OUT THE MESSAGE OF THE DAY IF THE USER HASN»T SEEN IT 
D CREATES AND USES A HQME DIRECTORY SEGMENT NAMED person_id .motd 
0 THIS COMMAND IS NORMALLY FOUND IN USER'S start__up.ec 
Q USAGE: print_motd 
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TOPIC IX 



THE ABBREV PROCESSOR 



Page 

What is the Abbrev Processor 9-1 

Abbrev Mechanism 9-2 

Abbrev Requests 9-4 

Abbrev Examples 9-8 
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WHAT IS THE ABBREV BOCESSQR 



• ABBREV PROCESSOR 



i A FACILITY ALLOWING USERS TO ABBREVIATE PARTS OF (OR WHOLE) 
COMMAND LINES 

B A SUBSYSTEM WHICH MUST BE EXPLICITLY INVOKED BY THE USER 
(ABBREV MODE) 

D FUNCTIONS 

D RESPOND TO ABBREV REQUEST LINES 

a EXPAND ABBREVIATIONS IMBEDDED IN COMMAND LINES 
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ASBREV MECHANISM 




abbrev, ab 



0 PLACES THE USER IK ABBHEV MODE. (INVOKES THE ABBREV PROCESSOR) 

D USAGE: abbrev 
ab 



• COMMAND LINE FLOW 



TYPED LINE 



i 



FRONT-END PROCESSOR 



1 



{ABBREV PROCESSOR} 




i 



COMMAND PROCESSOR 



i 



EXECUTION 
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ikB&REV MECHAIIISH 



• ABBREV MECHANISM 

S ABBREV PROCESSOR EXAMINES TYPED COMMAND LINES 

I ABBREV REQUEST LINES 

I BEGIN WITH 

II DEFINE, DELETE, LIST ABBREVIATIONS 
B CONTROL OTHER ABBREV OPERATIONS 

B COMMAND LINES 

B DO NOT BEGIN WITH »»." 

0 ANY AND ALL PREVIOUSLY DEFINED ABBREVIATIONS FOUND ARE 
EXPANDED 

fl COMMAND LINE IS THEN PASSED ON TO THE COMMAND PROCESSOR 
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ABBREV REQUESTS 




Q ADD AN ABBREVIATION TO THE USER*S PROFILE SEGMENT 

0 ABBREVIATIONS MUST BE 8 CHARACTERS OR LESS 

0 USAGE: .a abbrev itieahing-of-abbreviation 
.a F1 >udd>F01 
.a LARRY LJones.FED 



Q ADD AN ABBREVIATION WHICH IS VALID ONLY AT THE BEGINNING OF A 
COMMAND 

S USAGE: .ab abbrev meaning-of-abbreviatlon 



.ab 




.ab dp dprint -he T.Smith -ds Stat 14 



.ab cata list 



.ab GO ec run it.ec 
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ABBREV REQUESTS 




Q DELETE SPECIFIED ABBREVIATION (S) FROM THE USER'S PROFILE 

0 USAGE: .d abbrev1_. , .abbrevn 
.d LARRY 



0 LIST CURRENTLY DEFINED ABBREVIATIONS AND WHAT THEY STAND FOR 

0 USAGE: .1 {abbrev^. . .abbrevn} 
.1 

.1 F1 dp 



0 LIST ABBREVIATIONS THAT BEGIN WITH THE SPECIFIED LETTER (S) 

Q USAGE: .la letteM . . .lettern 
.la ID 
.la m d 




.la 



ABBREV REQUESTS 




0 QUIT USING THE ABBREV PROCESSOR 
E USAGE: .q 

.s 

u EXPAND AND SHOW THE COMMAND LINE WITHOUT EXECUTING IT 

Q USAGE: .s text 

.s cwd F1 ; dp add.pll 



9-6 



F01 



ABBREV REQUESTS 



li La£.v^ui£. J. 



HE COMMAND LINE WITHOUT EXPANDING IT 



0 USAGE 1: 

(DON'T EXPAND) 



text 



. print A. lunch. cb 



0 USAGE 2: 

(ACKNOWLEDGE) 



0 ACKNOWLEDGE THAT THE USER IS IN ABBREV MODE (ABBREV RESPONDS 
WITH "ab") 



D OFTEN USED TO AFFIRM COMMAND LEVEL WHEN "MULTING" WITH THE 
READY MESSAGE OFF 
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ABBREV EXAMPLES 



• LET TSmith's PROFILE SEGMENT CONTAIN THE FOLLOWING ABBREVIATIONS 



• EXAMPLES OF COMMAND LINE EXPANSION (IF IN ABBREV MODE) 



print array_dot .f t 
print array_dot . fortran 



sm LARRY Where's your dims program? 

sm LJones.FED Where's your dims program? 



cwd F1>Student_01 

cwd >udd>F01>Student 01 



dp add.pH 

dprint -he TSmith -ds Stat 14 add.pll 



list dp. ft 
list dp. fortran 



lunch 

sm LJones.FED Lunch time! 



ft 
cb 



fortran 
cobol 

LJones .FED 

>udd>ProjA>TSmith 

>udd>F01 

sm LJones.FED Lunch time! 
dprint -he TSMITH -ds Stat_14 



LARRY 

home 

F1 



lunch 



b dp 
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ABBREV EXAMPLES 



print A.lunch.cb 

print A.sm LJones.FED Lunch time! .cobol 



. print A.lunch.cb 
print A.lunch.cb 



. print A. lunch. cobol 
print A. lunch .cobol 



print clunch.cb 
print clunch. cobol 



print A_lunch.pl1 
print A__lunch.pl1 



• CANDIDATES FOR EXPANSION MUST BE 



B PART OF COMMAND LINE (MAY BE THE ENTIRE COMMAND LINE) 



B CHARACTER STRING, 8 CHARACTERS OR LESS, THAT ARE 



B BOUNDED BY BREAK CHARACTERS 



tab 




< 


newline 


• 


> 


space 


• 

f 


C 


n 


1 
1 


] 


$ 


( 


{ 




) 


} 



NOTE: : AND ? ARE NOT A BREAK CHARACTERS! 
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ABBREV EXAMPLES 



YOU ARE NOW READY FOR WORKSHOP 
#4 
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TOPIC X 



PROGRAMMING ON MULTICS 



Page 

What is Programming 10-1 

Developing a Source Program 10-4 

Compiling a Source Program 10-7 

Entrynaraes and Entry Point Names 10-11 

Executing an Object Program . 10-13 

Debugging Tools * 10-18 

Dynamic Searching ..... 10-21 
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WHAT IS PROGRAMMING 

• PROGRAM 

3 A LOGICAL SEQUENCE OF OPERATIONS TO BE PERFORMED BY A COMPUTER 

B SOURCE PROGRAM 

D WRITTEN IN AN ENGLISH-LIKE PROGRAMMING LANGUAGE 
II CREATED BY A USER VIA A TEXT EDITOR 
D KEPT IN A SEGMENT CALLED THE SOURCE SEGMENT 
11 CANNOT BE EXECUTED 

0 OBJECT PROGRAM 

B WRITTEN IN BINARY MACHINE LANGUAGE 

B CREATED BY A COMPILER (WHICH IS ALSO AN OBJECT PROGRAM) FROM 
THE SOURCE PROGRAM 

B. KEPT IN A SEGMENT CALLED THE OBJECT SEGMENT 

fl EXECUTED BY TYPING ITS NAME 
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WHAT IS PROGRAMMING 



• PROGRAMMING LANGUAGES SUPPORTED BY MULTICSO) 




- (VERSATILE, BLOCK 
TrmiRSIVE, MANY DATA TYPES) 



STRUCTURE, 



DYNAMIC ALLOCATION, 



0 FORTRAN (SCIENTIFIC COMPUTATIONS) 

D COBOL (BUSINESS APPLICATIONS, VERBOSE, WIDELY USED) 

a BASIC (COMPUTATIONS, EASY TO LEARN, LIMITED DATA TYPES) 

D APL (DATA MANIPULATION, CRYPTIC BUT POWERFUL) 

fl ALM (MULTICS ASSEMBLER LANGUAGE - YES! WE HAVE AN ASSEMBLER) 

• THERE EXISTS A SYSTEM PROGRAM, CALLED A COMPILER, FOR EACH 
PROGRAMMING LANGUAGE SUPPORTED. COMPILERS ARE DESIGNED TO 
TRANSLATE A PARTICULAR PROGRAMMING LANGUAGE INTO MACHINE LANGUAGE 



(1) RELATED MULTICS COURSES: APL (G11 & F11), BASIC (F127), COBOL-74 
(F13), FORTRAN (F14), PL/I (F15, F15C, F15D). 
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WHAT IS PROGRAMMING 



• PROGRAMMING 

B DEVELOPING THE SOURCE PROGRAM IN THE PROGRAMMING LANGUAGE OF 
CHOICE 

B COMPILING (TRANSLATING) THE SOURCE PROGRAM (SOURCE SEGMENT) 
INTO AN OBJECT PROGRAM (OBJECT SEGMENTl 

B EXECUTING THE OBJECT PROGRAM USING TEST DATA 

B DEBUGGING THE SOURCE PROGRAM TO (CORRECT ALL OBSERVED PROBLEMS 

B MAKING THE OBJECT PROGRAM AVAILABLE 

a SYSTEM PROGRAMS MUST BE "INSTALLED" IN ONE OF THE SYSTEM 
LIBRARIES 

B USER PROGRAMS NEED NO FURTHER ACTION EXCEPT THE SETTING OF 
ACCESS TO ALLOW USE BY OTHER USERS 
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DEVELOPING A SOURCE PROGRAM 

DESIGNING (OUTLINING) A SOURCE PROGRAM 
D TOP-DOWN DESIGN 
D MODULAR DESIGN 
Q FLOWCHARTING 

DOCUMENTING THE SOURCE PROGRAM 

B EXTERNAL DOCUMENTATION (PURPOSE, GENERAL DESIGN, HOW TO USE) 

0 INTERNAL DOCUMENTATION (STEP BY STEP DESCRIPTION OF THE 
PROGRAM) 

0 "SELF-DOCUMENTING" LANGUAGES 

WRITING (CODING) THE SOURCE PROGRAM- (USUALLY ON PAPER) IN SOME 
PROGRAMMING LANGUAGE 

1 "GO-TO-LESS" PROGRAMMING 
0 MNEMONIC VARIABLE NAMES 
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DEVELOPING A SOURCE PROGRAM 



0 ERROR DETECTION AND HANDLING 



• INPUTTING THE SOURCE PROGRAM, VIA A TEXT EDITOR, TO A SOURCE 
SEGMENT 



D A SOURCE SEGMENT MAY BE GIVEN ANY DESIRED NAME, HOWEVER, THE 
SUFFIX MUST BE THE ENTRYNAME OF THE PROGRAMMING LANGUAGE USED 

add.pll ran_num_gen .basic 

A__alpha.cobol page_fault .aim 

array__dot . f ortran 

OPTIONALLY FORMATTING THE SOURCE PROGRAM (COSMETICS) 



B SEVERAL COMMANDS EXIST FOR THE PURPOSE OF FORMATTING SOURCE 
PROGRAMS 



D DONE TO IMPROVE THE READABILITY OF A SOURCE PROGRAM 



0 THE COMMANDS DETECT AND REPORT CERTAIN TYPES OF SYNTAX ERRORS, 
AND ARE OFTEN USED AS A PRE-COMPILE EXAMINATION 
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DEVELOPING A SOURCE PROGRAM 



]] indent, ind 

fl IMPROVES THE READABILITY OF A PL/1 SOURCE SEGMENT 

Q USAGE: indent pathi {path2} {controi_arg} 
ind add.pll add.ind.pl1 
ind add.pll 

ind >udd>F01>Student__09>add .pll -indent 3 

B format_cobol_source , fcs 

B CONVERTS FREE-FORM COBOL SOURCE PROGRAMS TO FIXED-FORMAT 

fl USAGE: format__cobol_source pathi path2 

fcs A_alpha .cobol A_alpha . f cs .cobol 
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COMPILIHG A SOURCE PROGRAM 



• COMPILER: 

B A SYSTEM PROGRAM DESIGNED TO TRANSLATE A PARTICULAR PROGRAMMING 
LANGUAGE (ENGLISH-LIKE) INTO MACHINE LANGUAGE (BINARY) 

COMPILE COMMANDS (CREATE OBJECT PROGRAM AND OBJECT SEGMENT!) 



pl1 add.pH 

pl1 >udd>F01>Student_09>add.pl1 
cobol A_alpha .cobol 
fortran array_dot .fortran 
basic ran_num_gen .basic 
aim page_fault .aim 



e OBJECT PROGRAMS 

E ALL OBJECT PROGRAMS PRODUCED BY MULTICS COMPILERS ARE: 
D PURE (DO NOT MODIFY THEIR OWN CODE) 

II RE -ENTRANT (MORE THAN ONE USER MAY EXECUTE THE SAME CODE) 



0 RECURSIVE (A PROGRAM CAN CALL ITSELF). 

fl IN STANDARD FORMAT (OBJECTS GENERATED FROM DIFFERENT 
LANGUAGES MAY CALL EACH OTHER EASILY) 



D USAGE: 



language__name path {-control args} 




10-7 



F01 



COMPILING A SOURCE PROGRAM 



D THE OBJECT PROGRAM IS PLACED IN A SEGMENT (CALLED THE OBJECT 
SEGMENT) IN THE USER'S WORKING DIRECTORY 



0 THE OBJECT SEGMENT IS GIVEN THE CORRESPONDING SOURCE SEGMENT'S 
ENTRYNAME WITH THE SUFFIX REMOVED 

add ran_num_gen 

A_alpha page_fault 

array_dot 



rnMPTT FR T T<lTTMnQ 



D SOME CONTROL ARGUMENTS WILL CAUSE A COMPILER TO PRODUCE A 
COMPILER LISTING OPTIONALLY CONSISTING OF A LINE-NUMBERED 
SOURCE LISTING, A SYMBOL TABLE, AN OBJECT CODE MAP, ERROR 
MESSAGES, ETC. 



D THE COMPILER LISTING IS PLACED IN A SEGMENT (CALLED THE LIST 
SEGMENT) IN THE USER'S WORKING DIRECTORY 



D THE LIST SEGMENT IS GIVEN THE CORRESPONDING SOURCE SEGMENT'S 
NAME WITH THE ORIGINAL SUFFIX REPLACED BY THE SUFFIX list 

add. list ran__num__gen . list 

A_alpha.list page_fault . list 

array__dot .list 
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COMPILING A SOURCE PROGRAM 

• DIAGNOSTICS 

D COMPILERS WILL COMPLAIN ABOUT: 
0 SYNTAX ERRORS 
0 MISSPELLINGS 
0 UNDEFINED REFERENCES 

0 ERROR MESSAGES ARE PRINTED AT THE USER*S TERMINAL 

D SEVERE ERRORS WILL SUPPRESS THE FORMATION OF THE OBJECT PROGRAM 
AND OBJECT SEGMENT 



B THE FORMAT OF ERROR MESSAGES IS COMPILER-DEPENDENT. THE 
FOLLOWING IS A PL/I ERROR MESSAGE: 



ERROR 158, SEVERITY 2 ON LINE 30 

A constant immediately follows the identifier "zilch" 
SOURCE: a = zilch 4; 
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COMPILING A SOURCE PROGRAM 



-ibEA^ 



DEVELOPED 
INTO 



SOURCE 
PROGRAM 



WRITTEN 
(VIA EDITOR) 
INTO 



SOURCE 
SEGMENT 
(add.pll) 



INPUT TO 



FORMATS 



FORMATTING 
PROGRAM 



INPUT 
TO 



OBJECT 
PROGRAM 



PRODUCES 



Jfc. 



COMPILER 
(A PROGRAM) 



OPTIONALLY 
PRODUCES 



SOURCE 
LISTING 



WRITTEN 

(BY COMPILER) 

INTO 



OBJECT 
SEGMENT 
(add) 



(BY 



WRITTEN 
COMPILER) 
INTO 



LIST 
SEGMENT 
(add .list) 
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ENTRYNAMES AND ENTRY POINT NAMES 



ENTRYNAME ( 



0 A NAME GIVEN TO AN ITEM CONTAINED IN A DIRECTORY 



ENTRY POINT NAME 



B THE NAME ASSOCIATED WITH AN ENTRY POINT IN AN OBJECT SEGMENT 



UNLESS OTHERWISE SPECIFIED, MULTICS ASSUMES THE ENTRY POINT NAME 
IS THE SAME AS THE ENTRYNAME 
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$ (DOLLAR SIGN) 



D SEPARATES THE ENTRYNAME OF AN OBJECT SEGMENT FROM THE ENTRY 
POINT NAME WITHIN THE OBJECT SEGMENT 



Jl EXAMPLE USING AN OBJECT SEGMENT add HAVING ENTRY POINTS add AND 
max 




INVOKED 
AS 



add 

add$max 
max 



INTERPRETED 
AS 



add$add 
add$max 
max$max 



ENTRY 
POINT 



add 
max 

9 



0 EXAMPLE AS ABOVE WITH ALIAS NAME max ADDED TO THE SEGMENT 




INVOKED 
AS 



add 

add$max 
max 



INTERPRETED 
AS 



add$add 
add$max 
max$max 



ENTRY 
POINT 



add 
max 
max 



10-12 



F01 



EXECUtINg AN OBJECT PROGRAM 



• AN OBJECT PROGRAM (OBJECT SEGMENT) IS EXECUTED BY TYPING ITS NAME 
AT A TERMINAL 

add ran__num_gen 

A_alpha page__fault 

array dot >udd>F01 >Student 09>add 



• POSSIBLE RESULTS OF EXECUTING A PROGRAM 



0 PROGRAM RUNS TO NORMAL TERMINATION & USER RECEIVES READY 
MESSAGE 



D PROGRAM PAUSES FOR INPUT FROM THE USER'S TERMINAL 



PROGRAM HALTS BECAUSE OF A USER-IMPLANTED BREAKPOINT (A 
DEBUGGING TOOL) 



D PROfiRAM_jiAi*I§ BECAUSE OF A FATALJ EXECUTIQN ERROR 

0 OVERFLOW UNDERFLOW, DATA CONVERSION ERROR, . UNDEFINED 
REFERENCE 



D HALTS (INTERRUPTS) THE EXECUTION OF A PROGRAM OR COMMAND 
(FROZEN IN MID-AIR) 



D RESPONDS WITH A READY MESSAGE CONTAINING A level CLAUSE 
r 1038.5 0.185 0.012 27 
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EXECUTING AN OBJECT PROGRAM 

D PROGRAMJjAlT^ BECAUSE IJSEB^JS SUED A QUIT SIGNJ UL^ 

fl TERMINAL KEY LABELED ATTN, BRK, INTRPT, INTERRUPT,... 

0 HALTS (INTERRUPTS) THE EXECUTION OF A PROGRAM OR COMMAND. 
(FROZEN IN MID-AIR) 

II RESPONDS WITH A READY MESSAGE CONTAINING A level CLAUSE 
r 1038.5 0.185 0.012 27 level 2,11 
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EXECUTING AN OBJECT PROGRAM 



THE USER'S STACK (A HISTORY OF CURRENT EVENTS) 



1 user. init.admin — $ UMr.init~admin_ 



2 process. overseer _$ process_overs«fr— 



■User logs in. 

——Given default overseer. 



3 listen _ $ listen- 



level 1.3 



, Receives ready message. 
User types "add". 



4 abbrev_$abbrev— 



■Abbrev processor called. 



5 oommand_processor_$ command__processor_ 



"add" requests 
terminal read 
and then 
User hits "break 



6 command— procestor—$ read— list 



7 add$add 



read _J\ I I 
waits. • V I 

"hraaif" ^ > 



Command line 
is interpreted. 

Program "add" 
begins execution. 



8 tty_$ tty-get-line 



System 
recovers 
from "Break' 



9 ipc_$ block 

10 retiirn—to— ring— 0—$ return— to— ring— 0— 

in; 



default— error— handier— $ wall 



User receives 
level 2, 14 
ready message. 



1 1 



get— to— cl— $ unclaimed— signal 



13 listen— $ release— stack 



level 2, 13 
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EXECUTING AN OBJECT PROGRAM 



• POSSIBLE USER ACTIONS AFTER A QUIT SIGNAL OR FATAL ERROR 

D IGNORE THE OLD LEVEL(S) AND PROCEED (EXPENSIVE) 

D OBSERVE WHAT WAS HAPPENING USING DEBUGGING TOOLS 
value k 

value qty_on_hand 

D CHANGE VALUES OF VARIABLES USING DEBUGGING TOOLS 
let k=^4 

let qty__on_hand = 0 

fl start|Sji 



D RESTARTS THE PROGRAM OF THE IMMEDIATELY PREVIOUS LEVEL AT 
THE INTERRUPT POINT 



S USAGE: start 

fl EXAMPLE: WHILE IN qedx, THE USER SIGNALS QUIT WHILE DOING A 
1,$p. AFTER RECEIVING A READY MESSAGE THE USER TYPES start, 
AND THE 1,$p CONTINUES 
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EXECUTING kU O&JECt PROGHAM 



0 program__interrupt , pi 

Q RESTARTS THE PROGRAM AT A PROGRAMMER DETERMINED POINT 



0 PROGRAM MUST HAVE BEEN WRITTEN WITH A program_inter rupt 
HANDLER 



0 USAGE: program_interrupt 
pi 



Q EXAMPLE: WHILE IN qedx , THE USER SIGNALS QUIT WHILE DOING A 
l,$p. AFTER RECEIVING A READY MESSAGE THE USER TYPES pi, 
AND FINDS HIMSELF BACK IN THE EDITOR AT REQUEST LEVEL 



release, rl 



B RELEASES THE IMMEDIATELY PREVIOUS LEVEL (S) (ONE OR ALL) 

Q USAGE: release {-control_arg} 
rl 

rl -all 



F01 



DEBUGGING TOOLS 



• DEBUGGING TOOLS 

0 SUBSYSTEMS WHICH ARE USEFUL IN LOCATING, EXAMINING, AND 

CORRECTING UNEXPECTED OCCURRENCES OR CONDITIONS WITHIN OBJECT 
PROGRAMS 

D SUCH TOOLS MINIMIZE THE NEED FOR MEMORY DUMPS 

• debug, db 

0 INVOKES AN INTERACTIVE DEBUGGING AID 
D HARDWARE LEVEL, SYMBOLIC, CRYPTIC 

D PROCEDURES MAY HAVE ORIGINATED FROM ANY LANGUAGE. (SYMBOLIC 
CAPABILITY ONLY AVAILABLE FOR PL/I AND FORTRAN) 

0 IN ORDER TO UTILIZE SYMBOLIC CAPABILITIES, THE SOURCE PROGRAM 
MUST HAVE BEEN COMPILED WITH THE -table CONTROL ARGUMENT 

D USES A HOME DIRECTORY SEGMENT NAMED Person__id .breaks 

Q USAGE: debug 
db 
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DEBUGGING tOOLS 



probe, pb 



D INVOKES AN INTERACTIVE DEBUGGING AID 



D SYMBOLIC , SOURCE LEVEL 



PROCEDURES MUST HAVE ORIGINATED FROM PL/I, FORTRAN, OR COBOL 
SOURCE 



B IN ORDER TO UTILIZE SYMBOLIC CAPABILITIES, THE SOURCE PROGRAM 
MUST HAVE BEEN COMPILED WITH THE -table CONTROL ARGUMENT 



fl USAGE 1 : probe path 
(SETTING) 



USAGE 2: probe 
(EXAMINING) 



A THOROUGH DISCUSSION OF THE probe COMMAND MAY BE FOUND IN THE 
COMMANDS AND ACTIVE FUNCTIONS MANUAL AG92 
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DEBUGGING TOOLS 



DEBUG 
CAPABILITIES 

EXAMINE DATA, SOURCE AND OBJECT 
MODIFY DATA AND OBJECT 
EXECUTE COMMANDS 
CONDITIONAL BREAK POINTS 

EXAMINE MACHINE CONDITIONS 

EXAMINE REGISTERS 

DUMP DATA IN VARIOUS FORMATS 



PROBE 
CAPABILITIES 

EXAMINE DATA AND SOURCE 

MODIFY DATA 

EXECUTE COMMANDS 

CONDITIONAL BREAK POINTS 
AND/OR OPERATIONS 
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• RECALL: 

a COMMAND PROCEDURE 

0 A PROGRAM INVOKED BY TYPING ITS NAME 

D OBJECT PROGRAM 

0 EXECUTED BY TYPING ITS NAME 

• COMMAND LINE INTERPRETATION 

B THE FIRST WORD OF EVERY COMMAND IS ASSUMED TO BE THE NAME OF AN 
OBJECT PROGRAM 

list -all 
Is 

send_message Student__05.F01 Where are you? 
add 

0 MULTICS SEARCHES THROUGH VARIOUS (PREDETERMINED) DIRECTORIES TO 
FIND AN OBJECT SEGMENT HAVING THE SPECIFIED NAME 



D IF THE SEARCHING IS SUCCESSFUL, LINKING OCCURS ("THE LINK IS 
SNAPPED") AND EXECUTION COMMENCES 
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DYNAMIC SEARCHING 



• ALL COMMANDS (SYSTEM PROGRAMS), USER-WRITTEN PROGRAMS, AND 
SUBROUTINE MUST BE "FOUND»» BEFORE THEY CAN BE EXECUTED 



• SEARCH RULES (WHERE, WHERE) 



D A LIST SPECIFYING THE NAMES AND THE ORDER OF DIRECTORIES TO BE 
SEARCHED 



D SEARCH RULES ONLY HAVE SIGNIFICANCE FOR THE EXECUTION OF OBJECT 
PROGRAMS. COMMANDS SUCH AS list AND print DO NOT SEARCH FOR 
THEIR "TARGETS" 






initiated segments 
referencing directory 
working directory 
>system_library__standard 
>system_library_un bund led 
>system_library__1 
>system_library_tools 
>system_library__auth raaint 
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SEARCH RULES EXAMPLE FOR USER JONES 



working 
directory 



o 
I 

ro 




Jones' TERMINAL INPUT 



o 



COMMAND LINE TYPED 


SEGMENTS FOUND 


login Jones 
password 


r login RELATED ^ ^ 
V SEGMENTS 


pwd 


> sss > pwd 




> udd > . . . > Jones > S 

> udd > . . . > Jones > T 


> udd > . . . > Smith > XYZ 


> udd > . . . > Smith > XYZ 

> udd > , . . > Smith > R 


XYZ 


> udd > . . . > Smith > XYZ 

> udd > . . . > Smith > R 


ABC 


> udd > . . . > Jones > ABC 

> udd > . . . > Smith > R 


pr > udd > . . . > Smith > R.pll 
pr R.pll 


> sss > pr 

> sss > pr 








Jones' INITIATED SEGMENT LIST 



REFERENCE 




NAME 


SEGMENT INITIATED 


( i ) 


r login RELATED 




V SEGMENTS / 


pwd 


> sss > pwd 


s 


>udd > . . . > Jones >S 


T 


> udd > . . . > Jones > T 


XYZ 


> udd > . . . > Smith > XYZ 


R 


> udd > . . . > Smith > R 


ABC 


> udd > . . . > Jones > ABC 


pr 


> sss > pr 



se 

n 
o 

w 

> 

SO 

o 

se: 
o 



DYNAMIC SEARCHING 



• print search__rules , psr 



D PRINTS THE USER'S CURRENT SEARCH RULES 



fl USAGE: print_search__rules 
psr 



• add search rules, asr 




D ADDS A DIRECTORY TO THE USER'S SEARCH RULES 



E USAGE: add_search__rules pathi {-control_arg path2} 

asr >udd>F01 >Student 01>tools -after working_dir 



initiated segments 
referencing directory 
working directory 
>udd>F01 >Student__01 >tools 
>systera_library_standard 
>system_library__unbundled 
>system_library_1 
>systeni_library__tools 
>system library auth maint 
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DYNAMIC SEAHCHING 




• ^delete search rules, ^^t ( .^ jf^-^'^'^ ' 

D DELETES ONE OR MORE DIRECTOBltl FROM THE USER'S SEARCH RULES 

fl USAGE: delete_search__rules paths 

dsr >udd>F01>Student_06>tools 

• initiate, in 

0 ENABLES USERS TO INITIATE (MAKE KNOWN) SEGMENTS DIRECTLY 

D THE SEGMENTS REFERENCE NAME AND ITS ABSOLUT^: PATHNAME ARE 
PLACED IN THE USER'S LIST OF INITIATED SEGMENTS 

1 USAGE: initiate path {ref_naraes} {-control_args} 

in >udd>FED>Kerr>tools>editor 
in >udd>FED>Kerr>tools>editor qx 
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DtNAHIC SEARCHING 



• list ref names, Irn 




D LISTS THE REFERENCE NAME, PATHNAME AND SEGMENT NUMBER OF 
SEGMENTS KNOWN TO THE USER'S PROCESS (I.E. INITIATED SEGMENTS) 

Q USAGE: list_ref_names {paths} {-control_args) 
Irn 

Irn >udd>F01>Student__07>add 
• terminate ref_name, tmr 



0 ALLOWS THE USER TO REMOVE A SEGMENT FROM THE LIST OF SEGMENTS 
KNOWN TO HIS PROCESS (I.E. INITIATED SEGMENTS) 

fl USAGE: terminate_ref__name ref_names 
tmr add who 
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DYNAMIC SEARCHING 



where, wh ( . . . HOW I WONDER WHERE YOU ARE!) 



n USES CURRENT SEARCH RULES TO LOCATE AND PRINT THE ABSOLUTE 
PATHNAME OF A SEGMENT 



B ONLY THE PRIMARY NAME OF THE LOCATED SEGMENT IS PRINTED 

I MAY BE USED TO CHECK IF A NAME IS "SAFE" TO USE FOR A SEGMENT 

D USAGE: where ref_name {-control_arg} 
wh qx 
wh sort 
wh wh -all 

wh >udd>FD1>Student 06>add.pl1 



NOTE THAT IN THE SIMPLEST CASE (WHERE A USER LOGS IN, CREATES AND 
EXECUTES PROGRAMS IN HIS HOME DIRECTORY), NO KNOWLEDGE OF SEARCH 
RULES OR INITIATED SEGMENTS IS REQUIRED 



YOU ARE NOW READY FOR WORKSHOP 
#5 
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TOPIC XI 
ACCESS CONTROL 



Page 

What is Access Control ....... 1t-1 

Access Control List (ACL) 11-2 

Access Manipulation Commands 11-9 

Default and Initial ACL Entries 11-11 

Access Examples 11-13 
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WHAT IS ACCESS CONTROL 



• ACCESS CONTROL 

I A FACILITY FOR CONTROLLING (IN A SELECTIVE MANNER): 
D ACCESS TO THE CONTENTS OF SEGMENTS 
B ACCESS TO THE ATTRIBUTES OF SEGMENTS 
Q ABILITY TO CREATE SEGMENTS 
D ABILITY TO DELETE SEGMENTS 

0 A FACILITY ALLOWING USERS TO SELECTIVELY SHARE THEIR PROGRAMS 
AND DATA WITH OTHER USERS 

fl USER MUST EXPLICITLY GRANT (SET) ACCESS IF SHARING IS DESIRED 
fl set_acl, delete_acl & list_acl COMMANDS 

fi SELECTIVE SHARING 
fl BY Person_id 
B BY Project^id 

B BY ACCESS MODE (READ, WRITE ...) 
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ACCESS CONTROL LIST (ACL) 



ACCESS CONTROL LIST (ACL) 



D EVERY SEGMENT AND DIRECTORY HAS ITS OWN ACCESS CONTROL LIST 
(ACL) 



AN ACL IS A LIST OF User_ids-LIKE ENTRIES CALLED ACCESS 
IDENTIFIERS, AND ASSOCIATED ACCESS MODES 



r TSrnith.ProjA.* 
rw Stud6nt_0H.F01 .« 
r «,FED.« 



D IN ORDER FOR A USER TO ACCESS A SEGMENT (OR DIRECTORY): 



Q THE USER'S User id MUST "MATCH" AN ENTRY ON THE ACL 



D FURTHERMORE, THE USER IS RESTRICTED TO THE ACCESS MODE(S) 
SPECIFIED BY THAT PARTICULAR ACL ENTRY 



D BY DEFAULT, USERS ARE GIVEN COMPLETE ACCESS TO THE SEGMENTS AND 
DIRECTORIES THEY CREATE 



B USERS MAY ADD AND DELETE ENTRIES FROM THE ACL'S OF THEIR 
SEGMENTS AND DIRECTORIES VIA THE set_acl AND delete_acl 
COMMANDS 
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ACCESS CONTROL LIST (ACL) 



0 AN ACL IS CONSIDERED AN ATTRIBUTE OF A SEGMENT OR DIRECTORY. 
IN ORDER TO set acl OR delete_acl, THE USER MUST HAVE THE 
APPROPRIATE PERMISSION TO DO SO 



fi ACCESS VIOLATIONS ARE TRAPPED BY THE SYSTEM AND THE VIOLATOR IS 
INFORMED 



D ACCESS CHANGES OCCUR INSTANTANEOUSLY SINCE ACCESS RIGHTS ARE 
CHECKED BY HARDWARE WITH EVERY ACCESS 
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ACCESS CONTROL LIST (ACL) 



• ACCESS HODES FOR SEGMENTS (rew n) 



D READ (r) 




(1^ 



D CONTENTS OF THE SEGMENT CAN BE READ BY THE DESIGNATED 
USER(S) 



II print, copy, move, qedx*s "r" request 




\ CONTENTS OF THti SEUMKNT UAN tit tXtUUItU tJI THt i;t.i>iUNA 1 LU 
USER(S). (MFAffTMnFIII. ONT.Y FOR QBJRCT SEGMENTS) 



0 DEPENDING ON THE OBJECT PROGRAM, READ MAY ALSO BE REQUIRED 
FOR EXECUTION 



0 add, >udd>F01>Student_01>add 



Q WRITE (w) 




0 CONTENTS OF THE SEGMENT CAN BE MODIFIED (OVER WRITTEN) BY 
THE DESIGNATED USER(S) 

0 qedx*s "w" request 
0 NULL (n) ^^jj^i^^u^^ 



0 ALL ACCESS TO THE CONTENTS OF THE SEGMENT IS EXPLICITLY 
DENIED FOR THE DESIGNATED USER(S) 
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ACCESS CONTROL LIST (ACL) 




AC_C £SS MODES FOR DIRECTQ ffTF-^ - r.^ma n)— DO NOT INFLUENCE ACCESS ON 
INFERIOR DIRECTORIES 




D ATTRIBUTES OF EXISTING ENTRIES IN THE DIRECTORY CAN BE 
OBTAINED BY THE DESIGNATED USEft(S) 



0 status, list 



0 MODIFY (m) J 




0 ATTRIBUTES OF EXISTING ENTRIES IN THE DIRECTORY CAN BE 
MODIFIED BY THE DESIGNATED USER(S). 



D ENTRIES CAN ALSO BE DELETED BY THE DESIGNATED USER(S) 



add name, rename, delete, set acl, delete acl 



D APPEND (a) 



NEW SEGMENTS, DIRECTORIES, AND LINKS CAN BE CREATED IN (OR 
MOVED TO) THE DIRECTORY BY THE DESIGNATED USER(S) 




0 create, create_dir, link, copy, move 




NULL ( 



"'5 



fl ALL ACCESS TO THE ATTRIBUTES OF EXISTING ENTRIES IN THE 
DIRECTORY IS EXPLIClTT? 15ETOD FOR THE DESIGNATED USER(S) 
-AND- THE CREATION OF ENTRIES IN THE DIRECTORY IS EXPLICITLY 
DENIED FOR THE DESIGNATED USER(S) 
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ACCESS CONTROL LIST (ACL) 



• ACCESS IDENTIFIERS 

D THREE-COMPONENT CHARACTER STRING 

Person_id .Project_id .tag 

fl TAG IDENTIFIES THE TYPE OF PROCESS 

n a - AN INTERACTIVE PROCESS (A REAL USER) 

D m - AN ABSENTEE PROCESS (AN » ABSENT" USER) 

fl z - A SYSTEM PROCESS (A DAEMON) LOGGED IN BY THE OPERATOR 

J _MUL£ICS ^SIGNS EVERY J JSER A N ACCESS IDENTIFIER AT LOG IN 

0 WHEN USED IN AN ACCESS CONTROL LIST, ACCESS IDENTIFIERS ARE 
OFTEN CALLED "ACL ENTRIES" 

0 TR-JL^rnMPOHFMT ng — AALACL ^ENTRY IS A STAR (ASTER ISK). THE ST AR 
NiS,-ISTERPRETED AS MATCHING ANY Person^id ,^^fnfrTro ject_id , ~0R 
ANYtag' , DEPEN DING ON ITS POSITION IN THE ACCESS IDENTIFIER 

MATCHES ALL INTERACTIVE F01 USERS 

MATCHES Student__09 REGARDLESS OF 
HOW HE LOGS IN 

MATCHES ALL ABSENTEE USERS 

MATCHES EVERYONE 



*.F01.a 

Student_09.*.* 
« » « 
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ACCESS CONTROL LIST (ACL) 



ft FMTRTF^j;W_/\ ^FnMFHTt<^ Art. flBP! AUTOMATICALLY ORDERED - MOST 

— SfEtrlFlcTDENTIFIERS FIRST 

Frommer.FOI .a 

Frommer.FOI.* 

Frommer,*.a 

Frommer.*.* 

«.F01.a 

».F01.» 

«.«.a 
« « » 



• MATCHING User__id WITH ENTRIES ON AN ACL 
fl PROCEEDS FROM TOP TO BOTTOM 
0 FIRST MATCH DETERMINES ACCESS MODE(S) 
D NO MATCH IMPLIES NO ACCESS 
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ACCESS CONTROL LIST (ACL) 



EXAMPLE: LET seg_l HAVE THE FOLLOWING ACCESS CONTROL LIST 



seg 1 ' s ACL 



rew 


LJones.FED.a 


rw 


Student 07.F01 


r 


TSmith. ProjA.* 


rew 


White. ».» 


rw 


». ProjA. » 


n 


».FED.« 


rw 


* .SysDaemon .* 


n 




r 


« « ft 

• • 



USER 

LJones .FED.a 
LJones.FED.m 
TSmith. ProjA. a 
TSmith. FED. a 
Green. ProjA. a 
White. ProjA. a 
White. FED. a 
LJones. F01 .m 
LJones.FED.m 
Kerr .MAC. a 



USER'S ACCESS 
rew 
n 
r 
n 
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• set_acl, sa 





D MANIPULATES THE ACL»S OF SEGMENTS AND DIRECTORIES 



sa add.pll rw Student__04 .F01 . » 
sa add.pll r •.F01.« rw ».FED.» 
sa *.pl1 r LJones.*.* 
sa dlr_A sma LJones. FED.* 
sa ** r ^ 



• delete_acl, da 

D REMOVES ENTRIES FROM ACL »S OF SEGMENTS AND DIRECTORIES 
D USAGE: delete__acl {path {User_ids}} 



da add.pll ».F01.» 

da add.pH Student^OM .F01 .» ».FED.« 

da dir A LJones. FED.* 




2. . mod^^ U s e r_ i d^ > 




11-9 



F01 



ACCESS MANIPULATION COMMANDS 
list acl, la^' 



D LISTS THE ACL'S OF SEGMENTS AND DIRECTORIES 



a IF path OMITTED THEN NO User^id POSSIBLE 

D USAGE: list_acl {path {User_ids}} 
la add.pH 

la add.pH LJones.FED.* 

la 
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DErAULT AND INITIAL ACL EHTRIES 



WHEN SEGMENTS AND DIRECTORIES ARE CREATED, AN ACL IS AUTOMATICALLY 
PROVIDED BY MULTICS CONTAINING DEFAULT ACL ENTRIES 

D FOR MOST SEGMENTS: 

rw Person__id . Project__id .* 

rw * .SysDaemon .* 

fl FOR DIRECTORIES: 

sma Person__id . Pro ject_id * * 

sma * .SysDaemon .* 



NORMAL ACCESS GIVEN TO SYSTEM DIRECTORIES: 

fl A USER IS GIVEN "sma" ON HIS HOME DIRECTORY 

0 A USER IS GIVEN "s" ON HIS PROJECT DIRECTORY 

D A PROJECT ADMINISTRATOR IS GIVEN "sma»» ON THE PROJECT DIRECTORY 
fl THE SYSTEM'S ADMINISTRATOR HAS "sma" ON >udd 

11-11 F01 



DEFAULT AND INITIAL ACL ENTRIES 



• INITIAL ACCESS CONTROL LIST 

D A FACILITY FOR DEFINING ADDITIONAL DEFAULT ACL ENTRIES TO BE 
INCLUDED IN THE ACL OF SEGMENTS AND DIRECTORIES WHEN CREATED 

D DEFINABLE AT THE DIRECTORY LEVEL 

1 REFER TO THE DESCRIPTION OF THE FOLLOWING COMMANDS IN THE 
MULTICS COMMANDS MANUAL 

set_iacl_seg , sis set_iacl__dir , sid 

list__iacl_seg , lis list_iacl_dir , lid 

delete iacl seg, dis delete iacl dir, did 
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ACCESS EXAMPLES 



ACCESS EXAMPLE FOR STUDENT_02 



udd 



F01 



sma 



Student .01 



Student.02 



sa 



Dir.1 



sma 



rw 



Dir. 2 



Dir. 3 



Dir.4 



re 



w 



ra 



rw 



0 0 0© 



0 0 



© © 
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ACCESS EXAMPLES 



IN WHICH DIRECTORIES CAN Student_02 SUCCESSFULLY EXECUTE THE list 
COMMAND? 



IN WHICH DIRECTORIES CAN Student 02 CREATE A SEGMENT? 



• SUPPOSE Student_02 CREATES A SEGMENT IN DIRECTORY Dir_1 BY TYPING 
create >udd>F01 >Student_01 >Dir__1 >Z 



CAN Student_02 DELETE THIS SEGMENT? -^'^^ 
CAN Student__02 rename THIS SEGMENT? .-^^^ ^/ 
CAN Student__02 READ AND WRITE THE CONTENTS OF THIS SEGMENT? 



• IN WHICH DIRECTORIES CAN Student_02 SUCCESSFULLY EXECUTE THE 
rename COMMAND? ^,/7 - , 



IN WHICH DIRECTORY CAN Student 02 SUCCESSFULLY EXECUTE THE set acl 
COMMAND? 
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ACCESS EXAMPLES 



TO WHICH SEGMENTS CAN Student 02 WRITE? 



TO WHICH SEGMENTS COULD Student_02 EVENTUALLY WRITE BY SETTING THE 
APPROPRIATE ACCESS? 



• SUPPOSE Student__02 CREATES A DIRECTORY UNDER Dir__1 BY TYPING 
create dir >udd>F01 >Student 01>Dir 1>Dir 5 



WHAT PERMISSIONS WILL Student 02 HAVE ON THIS DIRECTORY? 5 



WHAT PERMISSIONS WILL Student 01 HAVE ON THIS DIRECTORY? 



CAN Student__01 GIVE HIMSELF PERMISSIONS ON Dir_5? /-^^z^ 
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TOPIC XII 



USER COMMUNICATION 



Page 

Message Facility 12-1 

Mail Facility 12-i| 

Memo Facility 12-6 
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MESSAGE FACILITY 





II TEXT WHICH IS COMMUNICATED BETWEEN USERS VIA THE send_niessage 
COMMAND 



fl A SEGMENT IN THE DIRECTORY >udd>Project__id>Person_id HAVING THE 
NAME Person id.mbx 



fl ALLOWS ANY AND ALL INCOMING MESSAGES TO BE PRINTED ON THE 
USER'S TERMINAL 

fl OTHERWISE, MESSAGE WILL GO TO THE USER'S MAILBOX 

fl ALSO CREATES A MAILBOX IF NONE EXISTS 

fl USAGE: aecept_inessages l-control_args} 






(I^M LISTENING) 



am 



am -print 



am -brief 



12-1 



F01 



MESSAGE FACILITY 




send message, sm 




0 SENDS A MESSAGE TO A SPECIFIED USER ON A SPECIFIED PROJECT 

fl SMALL MESSAGES (ONE LINE) 

Q MESSAGES ARE EITHER 

B PRINTED ON THE RECIPIENTS TERMINAL, OR 
1 PLACED IN THE RECIPIENTS MAILBOX 

D USAGE 1: send_message Person_id . Pro ject_id message 



sm TSmith.Project_id When are you going to lunch? 
sm Greenberg.FED May I have access to your file? 



sm TSmith.FED 
Input: 

When are you going to lunch? 

From TSmith.FED 11/10/78 1546.3 mst Fri: 12:00 
Mary wants to go with us. 
siFine, bring her along. 
Meet you in the lobby. 



Q USAGE 2: 
(DIALOGUE 



send message Person_id . Project 
M0DE7 
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MESSAGE FACILITY 



defer messages, dm y(I*M BUSY. .NO DISTRACTIONS WANTED) 




D REDIRECTS ANY AND ALL INCOMING MESSAGES TO THE USER'S MAILBOX 
fl ELIMINATES UNWANTED INTERRUPTIONS 
II USAGE: defer messages 



D PRINTS ALL MESSAGES STORED IN THE USER'S MAILBOX 

D MESSAGES ARE DELETED FROM THE MAILBOX WHEN PRINTED 

0 USAGE: print_messages {-control^arg} 
pm 

pm -last 



dm 
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MAIL ^AGILItY 



MAIL 



a^^4H«Ctt-I&^MMUNICATED BETWEEN USERS VIA THE mail COMMAND 



• mail, ml 



PRINTS ANY AND ALL MAIL (OR MESSAGES) IN A USER'S MAILBOX, OR 



SENDS THE CONTENTS OF A SEGMENT TO ANOTHER USER 




0 WHEN SENDING, NAIL IS PLACED IN THE RECIPIENT'S MAILBOX 

0 USAGE 1; mail {path} {-control_arg} 
(PRINTING) 

ml 

ml ~bf 

ml >udcl>F01 >Student_04>Student_Oi4 .rabx 
I ALSO CREATES A RING-PROTECTED MAILBOX IF NONE EXISTS 



USAGE 2; raaillpatii User__ids {-control arg} 
(SENDING) 

mail fw16. report LJones*FED 

mail letter Student_05 .F01 -ack 

mail S_letter .runout TSmith.ProjA Boyd. Pro jA 
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MAIL FACILITY 




USAGE 
(SENDING 



3: mail/ *yuser__i 
NG) ^ 



ds 



mail * L Jones. FED TSmith.ProjA 
Input: 

The finance committee will begin meeting 
onJTuesdays at 3:30 starting 

Coffee will be provided. 




RELATED COMMANDS 

mbx_create, mbcr 
mbx__delete, mbdl 
mbx__add__name , mban 
mbx_delete__name , mbdn 
mbx_rename, mbrn 
mbx_set__acl , mb$a 
mbx_delete_acl , mbda 
mbx_list_acl , mbla 
mbx_set_max_length , mbsml 



12-5 



F01 



MEMO FACILITY 



MEMO FACILITY 



0 AN INTERACTIVE NOTEBOOK AND REMINDER LIST 




D (ilAINTAINED BY THEAlSERv^N A HOME DIRECTORY SEGMENT NAMED 



0 A MESSAGE DELIVERED TO THE USER AT A PREDETERMINED DATE AND 
TIME, OR 

D A COMMAND EXECUTED BY THE SYSTEM AT A PREDETERMINED DATE AND 
TIME 

D MATURE MEMOS MAY BE ACTIVATED 

Q EXPLICITLY (VIA THE memo COMMAND), OR 
0 AUTOMATICALLY (WHILE USER IS LOGGED IN) 

1 MEMOS OPERATE INDEPENDENT OF THE accept_messages/clef er__messages 
COMMANDS 



MEMO 
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MEMO FACILITY 



memo 



D CREATES AND MAINTAINS AN INTERACTIVE NOTEBOOK AND REMINDER LIST 



0 USAGE 1: memo 
(EXECUTING) 

memo 



USAGE 2: memo -list { optional_args} 
(LISTING) 

memo -list 

memo -list -match Birthday 

USAGE 3: memo {optional_args} memo__text 
(SETTING) 

memo Good job Tom!!! Keep up the good work! 
memo -time "Friday 8am est" 10am meeting with Olson 
memo -date 5/6/78 -repeat lyear Jan's Birthday :May 9 
memo -call -tm Friday sm May ProjA Report due today, 
memo -alarm -repeat 1day -time noon Lunch time! 



Q USAGE 4: memo -delete optional___args 
(DELETING) 

memo -delete -match Birthday 
memo -delete -call 
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TOPIC XIII 



MULTICS INPUT/OUTPUT FACILITIES 



Page 

Multics Input/Output 13-1 

System Input/Output Modules 13-2 

Input/Output Switches 13-4 

Input/Output Commands . 13-10 

Examples 13-15 



\ 
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MULTICS INPUT/OUTPUT 



• LOGICAL I/O 



• DEVICE INDEPENDENT 



• SYSTEM I/O MODULES CONTROL THE PHYSICAL DEVICES 



• I/O »»SWITCHES" CHANNEL THE FLOW OF DATA BETWEEN PROGRAM ACCESSIBLE 
STORAGE AND DEVICES, FILES, ETC 
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SYSTEM INPUT/OUTPUT MODULES 



• SYSTEM INPUT/OUTPUT MODULES 



D THE Multics SYSTEM CONTAINS THE FOLLOWING I/O MODULES: 



0 discarcl_ 

IS A SINK FOR UNWANTED OUTPUT 



I rdisk__ 

SUPPORTS I/O FROM/TO REMOVABLE DISK PACKS 



i record__stream_ 

PROVIDES A MECHAiiISM FOR DOING RECORD I/O ON AN UNSTRUCTURED 
FILE, OR VICE VERSA 



I syn__ 

ESTABLISHES ONE SWITCH AS A SYNONYM FOR ANOTHER 



0 tape__ansi_ 

SUPPORTS I/O FROM/TO MAGNETIC TAPE FILES ACCORDING TO 
STANDARDS PROPOSED BY THE AMERICAN NATIONAL STANDARDS 
INSTITUTE (ANSI) 



0 tape__ibm__ 

SUPPORTS I/O FROM/TO MAGNETIC TAPE FILES ACCORDING TO 
STANDARDS ESTABLISHED BY IBM 



1 tape_inult_ 

SUPPORTS I/O FROM/TO MAGNETIC TAPE FILES IN Multics STANDARD 
TAPE FORMAT 
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SYSTEM INPUT/OUTPUT MODULES 



SUPPORTS I/O FROM/TO TERMINALS 
D vfile_ 

SUPPORTS I/O FROM/TO FILES IN THE STORAGE SYSTEM 



D THESE MODULES ARE DESCRIBED IN SECTION III OF THE MPM 
SUBROUTINES AND IN THE MPM PERIPHERAL INPUT/OUTPUT 



11 THE USER MAY CONSTRUCT HIS OWN I/O SYSTEM INTERFACE MODULES. 
SEE "WRITING AN I/O MODULE" IN SECTION IV OF THE MPM SUBSYSTEM 
WRITERS » GUIDE 
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INPUT/OUTPUT SWITCHES 



SOFTWARE CONSTRUCT WHICH MAKES I/O DEVICE INDEPENDENT 



« CONNECTS THE SOURCE OF A READ OR WRITE TO THE TARGET (FILE, TAPE, 
ETC.) THROUGH A SYSTEM I/O MODULE 





I discard) 
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iNPUT/DUTPUt SWITCHES 



TO PERFORM I/O, THE FOLLOWING FIVE STEPS MUST BE CARRIED OUT 
(EITHER EXPLICITLY OR IMPLICITLY); 



1) ATTACH AN I/O SWITCH. THIS STEP SPECIFIES THE SEGMENT 
PATHNAME, TAPE VOLUME NAME, ETC. FROM/TO WHICH THE 
INPUT/OUTPUT OPERATION IS MADE AND THE I/O MODULE WHICH 
PERFORMS THE OPERATION (vfile , tape ansi , etc.) 



2) OPEN THE I/O SWITCH. THIS STEP PREPARES THE SWITCH FOR A 
PARTICULAR MODE OF PROCESSING (E.G. READING RECORDS 
SEQUENTIALLY) USING THE ALREADY ESTABLISHED ATTACHMENT 



3) PERFORM THE REQUIRED DATA TRANSFER WORKING THROUGH THE SWITCH 

4) CLOSE THE I/O SWITCH 

5) DETACH THE I/O SWITCH 

SWITCHES MAY BE ATTACHED BY 

fl io_call COMMAND 

D SUBROUTINE CALL TO lox_$attach__ioname 

D LANGUAGE OPEN STATEMENT (IF NOT PREVIOUSLY ATTACHED) 

B DEFAULT WHEN RUNNING FORTRAN, PL/1 , AND COBOL 
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INPUT/OUTPUT SWItCHES 

• SWITCHES MAY BE OPENED BY 
0 io_call COMMAND 

II SUBROUTINE CALL TO iox_$open LANGUAGE 
fl LANGUAGE OPEN STATEMENTS 

B DEFAULT WHEN RUNNING FORTRAN, PL/1, AND COBOL 

• DATA TRANSFER MAY BE PERFORMED BY: 
0 io_call COMMAND 

D SUBROUTINE CALL TO iox__, ioa_ 

0 get, put, read, write, etc. In PL/1 

fl read, write, etc. in FORTRAN 

fl read, write, etc. in COBOL 

fl I/O STATEMENTS IN OTHER LANGUAGES 

13-6 F01 



INPUT/OUTPUT SWITCHES 

• THE I/O SWITCH MAY 3E CLOSED BY; 
I io^call COMMAND 

e LANGUAGE close STATEMENT (IF THE SWITCH WAS OPENED BY A 
LANGUAGE OPEN STATEMENT 

B close_file COMMAND 

• THE I/O SWITCH MAY BE DETACHED BY: 
D io_call COMMAND 

D SUBROUTINE CALL TO iox__$detach_iocb 

Q LANGUAGE close STATEMENT (IF THE SWITCH WERE ATTACHED BY THE 
LANGUAGE open STATEMENT) 
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IHPUT/QUTPUT SWITCHES 



• FOUR SWITCHES ATTACHED DURING PROCESS CREATION (login, new^proc) 
fl user_i/o 

0 user_input 
Q user__output 
0 error_output 

• user i/o IS ATTACHED TO THE USER'S TERMINAL THROUGH tty AN^ 
OPENiD FOR STREAM INPUT AND OUTPUT 

• user__input, user_output, and error_output ARE ATTACHED TO 
user_i/o THROUGH syn_ AND ARE OPENED FOR INPUT, OUTPUT, AND OUTPUT 
RESPECTIVELY 
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INPUT/OUTPUT SWITCHES 




INPUT/OUTPUT COMMANDS 



• io_call, io 



fl PERFORMS AN OPERATION ON A DESIGNATED I/O SWITCH 



fl USAGE: io_call opname switchname {args} 

io attach payroll_tape tape__ansi_ payrol 
-cr -nm employee rec 
-nb 1 -retain all 

io attach poem vfile_ >udcl>F01 >Student_02>The_Ra^/in 

io open poem stream_input 

io get__line poem 

io close poem 

io detach poem 



• close__file, cf 



D CLOSES SPECIFIED FORTRAN AND PL/1 FILES 

!l USAGE: close__file {-control_arg} filenames 
close_file poem file08 
close file -all 
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INPUT/OUTPUT COMMANDS 

• print__attach_table, pat 

0- PRINTS INFORMATION ON THE USER'S TERMINAL ABOUT I/O SWITCH 
ATTACHMENTS 

0 USAGE: print_attach_table {-control_args} {switch^names} 
pat 

pat poem 

• file_output, fo 

0 DIRECTS ALL SUBSEQUENT USER'S OUTPUT (TERMINAL OUTPUT) TO A 
SEGMENT UNTIL THE revert_output COMMAND IS ENCOUNTERED 

D ATTACHES user^output TO A SPECIFIED OUTPUT FILE 

D ERROR MESSAGES (IF THEY OCCUR) STILL APPEAR ON THE USER'S 
TERMINAL 

Q USAGE: file_output {path} 
fo who_save 
fo 
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iNPUt/OUTPUT COMMANDS 

• revert__output , ro 

Q RESTORES USER'S OUTPUT (TERMINAL OUTPUT) TO THE TERMINAL 

B USAGE: revert_output 
ro 
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INPUT/OUTPUT COMMANDS 



copy_file, cpf 

D COPIES RECORDS FROM A STRUCTURED INPUT FILE TO AN OUTPUT FILE 

0 USAGE: copy__file in__ctrl__arg out_ctrl_arg { -control__args} 

cpf -input_description "vfile_ >udd>F01 >Student_01 >funky" 
-output_switch funky_sw 

cpf -isw funky_sw -ods "tape^ansi foo -nm first_file -nb 1" 

cpf -ct 13 -ids "tape_ansi__ 887677 -nm TEST21 -ret all" 
-ods "record_sftream__ user_output" 

cpf 'isw in -osw out -from 43 =to 78 
copy__cards 

D COPIES SPECIFIED CARD IMAGE SEGMENTS FROM THE SYSTEM POOL 
STORAGE INTO A USER'S DIRECTORY 



D THE SEGMENTS TO BE COPIED MUST HAVE BEEN CREATED USING THE 
Multics CARD IMAGE FACILITY 

0 USAGE: copy__cards deck_name {pathname} 
copy_cards card_deck 
copy__cards card_deck my file 
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EXAHPLES 



• EXAMPLE 1 



E READ RECORDS FROM A TAPE WITH A VOLUME NAME OF payrol AND A 
FILE NAME OF emp 



D READ THESE RECORDS ONE AT A TIME FROM COMMAND LEVEL 

! io attach pt tape_ansi_ payrol -name emp -nb 1 -ret all 
! io open payroll _tape sequential_input 
! pat pt 

pt tape_ansi_ payrol -name emp -nb 1 -ret all sequential^input 

! io read pt 85 

io_call: 85 characters returned. 15093Robert Redford 553^ W. Yucca 

! io read pt 85 

io_call: End of information reached. No data returned by pt. 
! io close pt 
! pat pt 

pt tape_ansi_ payrol -name emp -number 1 -retain all 

(not open) 

! io detach pt 



0 NOTE: THE TAPE RESOURCES WERE ALLOCATED PRIOR TO THE ATTACH. 
OTHERWISE, A MESSAGE WHICH WOULD INDICATE THE TAPE WAS BEING 
MOUNTED WOULD HAVE BEEN RETURNED AFTER THE io attach 
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EXAMPLES 



• EXAMPLE 2 



Q READ DATA FROM A FILE AND WRITE TO ANOTHER 

fl USING THE SAME PROGRAM, READ FROM A FILE AND WRITE TO THE 

TERMINAL. (USE io^call AND ATTACH THE OUTPUT SWITCH EXTERNAL 
TO THE PROGRAM) 

D THE PROGRAM: 



example_2: proc; 

del payroll_in file, 

payroll_out file, 

sysprint file, 

1 emp_record, 

2 pay_no char (5), 

2 emp, 

3 name char (20), 

3 address char (20), 

(endfile, record, transmit) condition; 

on endfile (payroll_in) go to fini; 
on record (payroll in) ; 
on transmit (payroTl_in) begin; 
put skip list 

("TRANSMIT ERROR. LAST RECORD READ WAS:" , emp__record) ; 
go to fini; 

end; 

open file (payroll_in) 

title ("vfile_ payroll file") input; 

open file (payroll_outT 

title ("vfile_ payroll_file_2") output; 

do while ("1"b); 

get file (payroll_in) list (erap__record) ; 

put file (payroll~out) skip list (emp__record) ; 
end; " 

fini: close file (payroll in), file (payroll_out) ; 
put skip list ("done"); 
end example_2; 
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EXAMPLES 



D INPUT FILE, payroll^file: 

"12002", "Barbara Striesand", "4040 N. 30th lane" 
"15093", "Robert Redford", "5534 W. Yucca" 
"15666", "Julie Christie", "3322 W. Milky Way" 



0 SEQUENCE OF EXECUTION 
! example_2 



done 

! pr payroll_file_2 



payroll__file_2 11/09/78 1710.8 mst Thu 



"12002" "Barbara Striesand " "4040 N. 30th Lane " 
"15093" "Robert Redford " "5534 W. Yucca " 

"15666" "Julie Christie " "3322 W. Milky Way " 

! pat 

user_i/o ^^y_ tty724 stream_input_output 

user_input syn__ user_i/o 

user_output syn_ user__i/o 

error_output syn_ user_i/o 

sysprint syn_ user__output 

! io attach payroll__out syn__ user_output 
! pat payroll__out 

payroll__out syn_ user_output 

I example__2 

••12002" "Barbara Striesand " "4040 N. 30th Lane " 
"15093" "Robert Redford " "5534 W. Yucca " 

"15666" "Julie Christie " "3322 W. Milky Way " 

done 

! pat payroll_out 

payroll_out syn__ user_output 
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EXAMPLES 



YOU ARE NOW READY FOR WORKSHOP 
#6 
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EXAMPLES 



EXAMPLE 3 



0 READ A DECK OF CARDS INTO THE SYSTEM AND CREATE A SEGMENT IN 
YOUR WORKING DIRECTORY CONTAINING THE CARD IMAGES 



D STEP 1: YOU MUST BE REGISTERED BY THE SYSTEM ADMINISTRATOR FOR 
CARD INPUT. YOU WILL RECEIVE A PASSWORD FOR YOUR CARD DECKS 



STEP 2: CREATE A SEGMENT IN YOUR HOME DIRECTORY CALLED 
card input. acs 



STEP 3: SET ACL ON THE SEGMENT TO "r" FOR <STATION_ID> . * . » ANf 
FOR Card Input . Daemon . * 



0 STEP i»: PREPARE THE CARD DECK 

++DATA DECK_NAME PERSON__ID PROJECT_ID 
++PASSWORD XXX 
++FORMAT MCC LOWERCASE 
++INPUT 



STEP 5: SUBMIT THIS DECK TO THE OPERATOR. A MESSAGE WILL BE 
SENT TO YOU WHEN IT HAS BEEN READ 



STEP 6: EXECUTE THE COPY CARDS COMMAND 
copy__cards deck_name 
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TOPIC XIV 



MORE ABOUT THE ABBREV PROCESSOR 



Page 

The do Command .14^1 
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THE DO COMMAND 



MOTIVATION: 

D WOULD LIKE TO BE ABLE TO DO THE FOLLOWING: 
.ab PL1 ind; pll 
PL1 add.pH 

II WHICH EXPANDS TO: 

Ind; pl1 add. pll 



0 BUT WANT: 



ind add.pH; pll add. pll 



• do 



D SUBSTITUTES SUPPLIED ARGUMENTS INTO A COMMAND LINE 



0 PRIMARILY INTENDED FOR USE IN ABBREVIATIONS 



fl USAGE: do "command line" args 



do "ind &1; pl1 &1" add.pH 




do "ind &1; ind &2; ind &3" add. pll sub.pH mult.pH 
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THE DO COMMAND 



• COMMAND LINE FLOW 

TYPED LINE 

i 

FRONT-END PROCESSOR 

1 

{ABBREV PROCESSOR} 

i 

COMMAND PROCESSOR -> do COMMAND PROCEDURE 

1 

▼ 

EXECUTION 
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THE DO COMMAND 



• EXAMPLES USING THE FOLLOWING ABBREVS: 



PL1 


do 


»»ind 


i1; pll &1" 


PLI^DP 


do 


"PLl 


&1; dp &1" 


PL1__EX 


do 


"ind 


&1.pl1; pl1 &1.pl1; &1" 



Q EXAMPLE 1: 
PL1|add.pl1 

do "ind &1; pll add.pll 
ind add.pH; pll add.pll 

0 EXAMPLE 2: 

PL1_EX^add (AS TYPED) 

do "ind &1.pl1; pll &1.pl1; &1"ladd (ABBREV PROCESSOR) 

ind add.pll; pll add.pH; add (DO COMMAND) 



(AS TYPED) 
(ABBREV PROCESSOR) 
(DO COMMAND) 
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THE DO COMMAND 



B EXAMPLE 3: 

,PL1_DP add.pH ' (AS TYPED) 



1 



'do "PL1 &1; dp add.pll (ABBREV PROCESSOR) 

PL1 add.pH; dp add.pll (DO COMMAND) 

'do "ind &1; pl1 &1 add.pll ; dp add.pll (ABBREV PROCESSOR) 

ind add.pll; pll add.pll; dp add.pll (DO COMMAND) 
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AREAS FOR ADDITIONAL STUDY 



m ADDITIONAL DOCUMENTATION 

D MPM COMMANDS AND ACTIVE FUNCTIONS (AG92) 
Q help abbrev 

• STUDY TOPICS 

D ADDITIONAL abbrev REQUESTS 



0 .u (USE ANOTHER PROFILE) 

B .p (PRINT THE PATHNAME OF THE PROFILE BEING 

USED) 

D .af (FORCE REDEFINE) 

D .abf (FORCE REDEFINE) 

0 .r (REMEMBER MODE) 

D .f (FORGET MODE - THE DEFAULT) 

0 .s (SHOW LAST LINE) 
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TOPIC XV 



ACTIVE FUNCTIONS 



Page 
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WHAT is AN ACTIVE FUNCTION 



• ACTIVE STRING 



S A SUB-STRING (A PART) OF A COMMAND LINE DELIMITED (SET OFF) BY 
SQUARE BRACKETS 



i INTENDED TO BE REPLACED BY A CORRESPONDING VALUE 



I EXAMPLES: 

sm Clast_message_sender3 Thank you! 
sm LJones.ProjA Thank you! 

delete Coldest_segment] 
delete seg 1 



B LIKE A DYNAMIC (OR VARIABLE) ABBREVIATION 



Q FREQUENTLY USED WITHIN ABBREVIATIONS 



11 THERE ARE MORE THAN 70 ACTIVE STRINGS DEFINED BY MULTICS 
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WHAT IS AN ACTIVE FUHCtlON 

ACTIVE FUNCTION 

D A PROGRAM EXPLICITLY DESIGNED TO EVALUATE AND RETURN THE VALUE 
OF AN ACTIVE STRING 

D USERS HAY DEFINE THEIR OWN ACTIVE STRINGS AND WRITE THEIR OWN 
CORRESPONDING ACTIVE FUNCTIONS 

Q MANY ACTIVE FUNCTIONS MAY ALSO BE INVOKED AS COMMANDS 
Iast_message_sencler 
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ACTIVE FUNCTION MECHANISM 



• ACTIVE FUNCTION MECHANISM 

D ACTIVE STRINGS ARE IMMEDIATELY EVALUATED (EXECUTED) 

i 

D THE RESULTING VALUE IS SUBSTITUTED FOR THE ACTIVE STRING IN THE 
COMMAND LINE 

I THE COMMAND LINE IS THEN RETURNED TO THE COMMAND PROCESSOR 

• COMMAND LINE FLOW 



TYPED-LINE 




FRONT-END PROCESSOR 




{ABBREV PROCESSOR} 




COMMAND PROCESSOR 



ACTIVE FUNCTION 



EXECUTION 



F01 



ACTIVE FUNCTION EXAHPLES 



last message sender, 1ms 



Q RETURNS THE User Id OF THE SENDER WHO SENT THE LAST MESSAGE 
RECEIVED 



Q USAGE 1: last_message_sender 
1ms 

LJones.FED 



0 USAGE 2: [last_message_sender] 

m [1ms] THANK YOU! 

sm LJones.FED THANK YOUt 

who [1ms] 

who LJones.FED 



wd 



D RETURNS THE PATHNAME OF THE USERS WORKING DIRECTORY 



Q USAGE 1: wd 



wd 

>udd>FED>May 



0 USAGE 2: [wd] 



sm Kerr. FED THE pathname is [wd]>add.pl1 

sm Kerr. FED THE pathname is >udd>FED>May>add .pll 
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ACTIVE FUNCTION EXAMPLES 



• date 



D RETURNS THE DATE IN mm/dd/yy FORH 



D USAGE 1: date {dt} 

date 
11/01/77 

date "12 June" 
06/12/78 



0 USAGE 2: [date {dt}] 



create alpha.version__[dat€3 .pll 
create alpha.version_1 1/0 1/77. pll 



• home dir 



D RETURNS THE PATHNAME OF THE USERS HOME DIRECTORY 



0 USAGE 1: home dir 



home__dir 

>udd>F01>Student 07 



O USAGE 2: [home dir] 



pr [home_dir]>add.pl1 

pr >udd>F01>Student__07>add.pl1 
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ACTIVE FUNCTION EXAMPLES 



• segments, segs 



D RETURNS THE ENTRYNAMES (SEPARATED BY A BLANK) OF ALL SEGMENTS 
MATCHING A GIVEN STARNAME 



0 USAGE: [segments starname] 

dprint [segs ••.pll] 
dprint add.pH seg_1.pl1 



wn ueti wo 



D RETURNS THE CONTENTS OF A SPECIFIED ASCII SEGMENT SEPARATED B' 
BLANKS 



D USAGE: [contents path] 

sm TSmlth.FED Their names are: [contents Names] 
sm TSmlth.FED Their names are: LJones.FED Kerr. MED 

mail letter. 2 [contents Names] 
mail letter. 2 LJones.FED Kerr. MED 
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AREAS FOR ADDITIONAL STUDY 



• ADDITIONAL DOCUMENTATION 

0 MPM COMMANDS AND ACTIVE FUNCTIONS (AG92) 
0 help <active function name> 



• STUDY TOPICS 

I ARITHMETIC ACTIVE FUNCTIONS 

Q ceil, divide, floor, max, min, minus, mod, plus, quotient, 
times, trunc 

0 CHARACTER STRING ACTIVE FUNCTIONS 

fl default, format^line, index, index_set, length, search, 
string, substr, underline, unique, verify 



D DATE AND TIME ACTIVE FUNCTIONS 



date, date__time, day, day_name, hour, long__date, minute, 
month, month_name, time, year 



D LOGICAL ACTIVE FUNCTIONS 



0 and, equal, exists, greater, less, nequal, ngreater, nless, 
not, or 
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AREAS FOR ADDITIONAL STUDY 



1 PATHNAME MANIPULATION ACTIVE FUNCTIONS 

I directory, entry, equal_name, path, strip, strip_entry, 
suffix 

D QUESTION ASKING ACTIVE FUNCTIONS 
0 query, response 

0 STORAGE SYSTEM ATTRIBUTES ACTIVE FUNCTIONS 
0 lv_attached , status 

D STORAGE SYSTEM NAMES ACTIVE FUNCTIONS 

Q directories, files, get_pathname , home^dir, links, 
nondirectories, nonlinks, nonsegments, pd, segments, wd 

0 USER PARAMETER ACTIVE FUNCTIONS 

II have_fflail, last_message__sender , last__message__time, 
last message, system, user 
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TOPIC xvi 



HOHE ABOUT EXEC_COM»S 



Page 

Review 16-1 

Argument Substitution 16-3 

Control Statements 16-M 

Exec_com Examples . 16-10 

Areas for Additional Study 16-13 
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REVIEW 



EXEC__COM 

3 A SEGMENT CONTAINING A SERIES OF COMMAND LINES . 
0 CREATED USING A TEXT EDITOR 
D NAME MUST HAVE SUFFIX OF ec 

D THE COMMAND LINES ARE EXECUTED SEQUENTIALLY, AS A SET, WHENEVER 
INVOKED BY THE USER 

S ABBREVIATIONS ARE EXPANDED IN THE NORMAL MANNER 

E MAY BE RECURSIVELY INVOKED 

exec_com, ec 

0 EXECUTES THE COMMAND LINES CONTAINED IN AN EXEC__COM SEGMENT 

D USAGE: exec^coin path {optional_args} 
ec A.ec 

ec weird. ec flower tree add 
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REVIEW 



• EXEC_COM LINE FLOW 

EXEC COM LINES 

"i 

{ABBHEV PROCESSOR} 

i 

COMMAND PROCESSOR 

1 

EXECUTION 



I 



I 
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ARGUMENT SUBSTITUTION 



• ARGUMENT SUBSTITUTION 

B CERTAIN CHARACTER STRINGS ARE REPLACED BY A CORRESPONDING VALUE 
BEFORE THE EXEC__COM IS EXECUTED 

D EXAMPLES USING EITHER OF THE FOLLOWING COMMAND LINES 
ec weird. ec flower tree add 

ec >udd>F01>Student__05>weird.ec flower tree add 
D &<number> 

D REPLACED BY THE CORRESPONDING OPTIONAL ARGUMENT 
(POSITIONAL) 

&1 4~flower 

&3 i — add 

&5 4~<nothing> 

0 &n 

0 REPLACED BY THE NUMBER OF ARGUMENTS SUPPLIED 
&n 4 — 3 

11 &ec_name 

Q REPLACED BY THE ENTRYNAME PORTION OF THE EXEC^COM'S 
PATHNAME WITHOUT THE ec SUFFIX 

&ec_name ^— weird 
Q &ec__dir 

D REPLACED BY THE DIRECTORY NAME PORTION OF THE EXEC COM 
PATHNAME 

&ec dir 4— >udd>F01 >Student 05 
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CONTROL STATEMENTS 

• CONTROL STATEMENTS 

B EXEC__COM LINES THAT BEGIN WITH SPECIAL KEY WORDS 

fl ALL KEY WORDS BEGIN WITH & (AMPERSAND) 

Q PROVIDE VARIETY AND CONTROL DURING EXECUTION 

• &command_llne off 

0 SUPPRESSES THE PRINTING OF SUBSEQUENT COMMAND LINES 
Q USAGE: &comroand_line off 

• &command_line on 

D CAUSES SUBSEQUENT COMMAND LINES TO BE PRINTED. (THE DEFAULT) 
fl USAGE: &coiDmand line on 
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CONtROL STAtEMENTS 



• &print text 



D CAUSES THE TEXT FOLLOWING &print TO BE PRINTED ON THE USER'S 
TERMINAL 



0 USAGE: &prlnt text 

&print BEGINNING COMPILE PHASE 




0 _ _ m A PLACE TO WHICH AN &goto TRANSFERS CONTROL 



Q USAGE: &label label_name 
&label Arg_Check 
&label &1 




• &goto location 




D CAUSE CONTROL TO BE TRANSFERRED TO THE PLACE SPECIFIED 



fl USAGE: &goto label__naine 
&goto Arg_Check 
&goto &1 
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stty e^Uf(^)c^ ^o-^e ^r^-f(-r 

' CONTROL STATEMENTS 





&if , &then, &else ^ 



0 ALLOWS EXEC COM LINES TO BE CONDITIONALLr INTERPRETED 



0 USED WITH LOGICAL ACTIVE FUNCTIONS (WHICH RETURN »*true" OR 
"false") 



USAGE 1: &if [ACTIVE^FUNCTION {ai^gs}] 
&then EXEC__COM STATEMENT 

&if [exists seg add.pll] 
&then pll add.pl1;add 



0 USAGE 2: &if [ACTIVE^FUNCTION {args}] 
&then EXEC COM STATEMENT 
&else EXEC^COM STATEMENT 

&if [equal [wd] [home_dir]] 
&then &goto OK 

&else &print Assuming working_dir is correct 



& 



D USED TO INDICATE A COMMENT LINE 



D USAGE: & text 



& THIS EXEC__COM DETERMINES THE USER'S Project id 
& AND THE TIME OF DAY IN ORDER TO 
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CONTROL STATEMENTS 



&quit 



0 CAUSES EXECUTION OF THE EXEC__COM TO HALT (DEFAULT AT END OF 
SEGMENT) 



0 USAGE: &qult 




CAUSES SUBSEQUENT COMMANDS WHICH NORMALLY TAKE THEIR INPUT FROM 
THE TERMINAL TO TAKE THEIR INPUT FROM THE EXEC COM SEGMENT 



fl USAGE: &attach 




D EXAMPLES: 



qedx REQUESTS ARE 
READ FROM TERMINAL 



qedx REQUESTS ARE 
READ FROM EXEC COM 



&command_line off 
cwd >udd>FED>May 
qedx 

cwd >udd>FED>Kerr 



&coramand_line off 
&attach 

cwd >udd>FED>May 

qedx 

r seg__1 

1 ,$s/once/twice/w 

q 

cwd >udd>FED>Kerr 
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CONTROL STATEMENTS 



• &detacj 




USED TO REVERT &attach 



Q CAUSES SUBSEQUENT COMMAND WHICH NORMALLY TAKE THEIR INPUT FROM 
THE TERMINAL TO CONTINUE TO TAKE THEIR INPUT FROM THE TERMINAL 




D THE DEFAULT WHEN ENTERimTAN EXEC CO 



0 USAGE: &detach 



• &input_lin€ off 



D SUPPRESSES THE PRINTING OF SUBSEQUENT INPUT LINES (SUCH AS 
REQUEST LINES) 



D USAGE: &input_line off 




• &input_line on 




D CAUSE SUBSEQUENT INPUT LINES TO BE PRINTEDV (DEFAULT) 
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CONTROL STATEMENTS 



&ready on 




CAUSES THE INVOCATION OF THE USER'S READY PROCEDURE AFTER THE 
EXECUTION OF EACH COMMAND LINE WITHIN THE EXEC COM 




CAUSES THE USER'S READY PROCEDURE NOT 
WITHIN THE EXEC COM 



TO BE INVOK 



(DEFAULT) / 




exec com DEFAULTS: 




& comma nd__line on 
&input_line on 
&ready off 
&detach 
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EXEC COM EXAMPLES 



EXAMPLE 1: LET pl1_pr.ec CONTAIN: 

pl1__pr.ec 



ind &l.pll 




pll &1.pl1 


>map 


dp &1.1ist 




ind &2.pl1 




pl1 42.pl1 


-map 


dp &2.1ist 





Q LET THE COMMAND LINE BE: ec pl1_pr.ec add sub 



Q LET THE COMMAND LINE BE: ec pl1_pr.ec sub 



EXAMPLE 2: LET pl1_pr.ec CONTAIN: 

pl1__pr .ec 



&comn^ind_line off 

&if Unless &n 1] &then &quit 

ind &1 .pl1 

pl1 &1.pl1 -map 

dp &1 .list 

&if (Jji(^qual^)&n 1] &then &quit 



ind &2.pl1 
pll &2.pl1 -map 
dp &2.1ist 
&quit 




EXEC COM EXAMPLES 



EXAMPLE 3: LET pl1_pr.ec HAVE AN ADD NAME OF pl1_pr_.ec AND 
CONTAIN: 

pl1_pr.ec 
pl1_pr_.ec 



&goto &ec_name 
&label pl1_pr 
&commancl_line off 

&print Beginning &ec_name exec_com 
&if [ngreater &n 0] &then &goto pl1__pr_ 
&print Usage is: ec &ec_name.ec paths 
&quit 

&label pl1_pr_ 
dl &1 -brief 
ind &1 .pl1 
pl1 &l.pl1 -map 

& CHECK FOR A SUCCESSFUL COMPILE. (WAS OBJECT CREATED). 
&if [exists segment 6iM &then dp &1.1ist 

&if [ngreater &n 1] &then ec &ec__dir>pll_pr_.ec &2 &3 &^ 
&quit 
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ADDITIONAL EXAMPLES OF EXE C_COM CONTROL STATEMENTS: 

&if [equal [day_name] Monday] &then 

&if [query "Do you really ...?"] &then. 

&lf [equal all [response "How many do you want?**] ] &then 
&if [equal TSmith.PED [last_message_sender] ] &then .... . 

&if [equal S [substr [user name] 11]] &then 

&if [equal 0 [min &1 &2 &3 &4] ] &then 

&lf [or [equal ] [less ] ] &then 

&if [nless 0 [index **&1 &2 &3 &4** -all] ] &then 

&lf [equal 0 [mod &n 2] ] &then 
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AREAS FOR ADDITIONAL STUDY 



• ADDITIONAL DOCUMENTATION OF exee^com FACILITIES: 
9 MPM COMMANDS AND ACTIVE FUNCTIONS (AG92) 

0 help exec_com 

' ■ ■ . 

• STUDY TOPICS 

0 ARGUMENT SUBSTITUTION 

fl &qi, &ri (QUOTING AND REQUOTING OF ARGUMENTS) 

D &fi (THE ARGUMENT STRING STARTING WITH THE iTH ARGUMENT) 

1 &qfi, &rfi (QUOTING AND REQUOTING OF ARGUMENT STRINGS) 

0 CONTROL STATEMENTS 

B &print CONTROL STRINGS: V, "3/, '^4-, '^1, '^21, '^^ 



YOU ARE NOW READY FOR WORKSHOP 
#7 
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TOPIC XVII 



ABSENTEE USAGE 



Page 

What is Absentee Usage 17-1 

Absentee Commands .......... 17-7 

Areas for Additional Study . . . . . . . . . 17-9 
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WHAT IS ABSEHTEE USAGE 

ABSENTEE FACILITY 

1 A FACILITY FOR RUNNING BACKGROUND JOBS (i.e. BATCH JOBS) 

0 GIVES USERS THE ABILITY TO EXECUTE LARGE JOBS WITHOUT WAITING 
AT THE TERMINAL WHILE THE JOB IS IN PROGRESS 

1 CHARGES FOR ABSENTEE USAGE IS USUALLY LOWER THAN CHARGES FOH 
INTERACTIVE USAGE 

& A USER MAY RUN MANY ABSENTEE JOBS AT ONCE, BUT IS SUBJECT Ta 
THE CURRENT SYSTEM LIMIT ON THE NUMBER OF ABSENTEE JOBS 

1 LANGUAGE FOR ABSENTEE USAGE IS IDENTICAL TO THE INTERACTIVE 
COMMAND LANGUAGE 

PROCESS 

0 A PROGRAM CREATED FOR THE USER AT LOG IN, AND DESTROYED AT LOG 
OUT 

li AN ACTIVE AGENT WHICH DOES WORK FOR THE USER 

B LIKE A PRIVATE COMPUTER, WORKING IN ITS OWN MEMORY UNDER THE 
CONTROL OF THE USER 

17-1 F01 



WHAT IS ABSENTEE USAGE 

• INTERACTIVE USAGE 

D USING MULTICS INTERACTIVELY VIA A TERMINAL 
I USER'S PROCESS INTEftACTS WITH THE USER 

• ABSENTEE USAGE 

I USING MULTICS WHILE ABSENT FROM A TERMINAL 

D USER'S PROCESS "INTERACTS** WITH AN INTERACTIVE SCRIPT 

0 AN ABSENTEE JOB IS A "PLANNED** INTERACTIVE TERMINAL SESSION 
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WHAT IS ABSENTEE USAGE 



• ABSENTEE MECHANISM 

S USER CREATES AN ABSENTEE INPUT SEGMENT CONTAINING COMMANDS TO 
BE EXECUTED 

fl THE ABSENTEE INPUT SEGMENT 
E MUST HAVE SUFFIX OF absin 

D CONTAINS A PLANNED INTERACTIVE SCRIPT, INCLUDING PRESET 
ANSWERS TO ANTICIPATED QUESTIONS 

a HAS THE SAME SYNTAX AS EXEC_COM SEGMENTS 

i USER REQUESTS THE EXECUTION OF THE ABSENTEE INPUT SEGMENT VIA 
THE enter abs request COMMAND 



1 EXECUTION MAY BE DEFERRED UNTIL A SPECIFIED DATE AND TIME 



0 THE ABSENTEE REQUEST IS QUEUED AND RUN AS BACKGROUND TO THE 
NORMAL INTERACTIVE WORKLOAD 



a ALL OUTPUT NORMALLY DIRECTED TO THE TERMINAL IS REDIRECTED TO A 
SEGMENT HAVING THE SAME NAME AS THE ABSENTEE INPUT SEGMENT 
EXCEPT THE SUFFIX IS absout 
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WHAT IS ABSENTEE USAGE 



INTERACTIVE USAGE 




t I 



DATA 
FILE 



ABSENTEE USAGE 




COMMANDS 



RESPONSES 



FILE I/O 



A.absin 



A.abiout 



IMA « «t •« 



• U •• • • ■ 

• wiMM • • • 
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WHAT IS ABSENTEE USAGE 



THE ABSENTEE PROCESS WHICH RUNS THE JOB: 



I LOGS INTO THE SYSTEM AS DOES ANY USER (EXCEPT FOR PASSWORD 
AUTHENTICATION) 



fl EXECUTES THE ABSENT USER'S start-up. ec 



D BEGINS WORKING IN THE ABSENT USER'S HONE DIRECTORY 



0 TAKES ITS COMMANDS FROM THE ABSENTEE INPUT SEGMENT 



B APPEARS (AND IS) ANOTHER USER HAVING THE ABSENT USER'S User id 



COMMAND LINE FLOW 



ABSENTEE INPUT 

I 

{ABBREV PROCESSOR} 

i 

COMMAND PROCESSOR 

i 

EXECUTION 
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WHAT IS ABSENTEE USAGE 



0 



e 



fl 



ES ON ABSENTEE USAGE 

Start up.ec SHOULD BE MODIFIED TO RESPOND DIFFERENTLY TO AN 
ABSENTEE LOG IN 



I THE SYSTEM EXECUTES A USER'S start up.ec WITH ONE OF THE 
FOLLOWING COMMAND LINES: 



D THE USER MAY QUERY THE ARGUMENTS USING exec^com LINES 

SIMILAR TO THE FOLLOWING: 

&if [equal &1 login] &then ... 

&lf [equal &2 absentee] &then ... 



THE ABSENTEE INPUT SEGMENT MUST CONTAIN change wdir COMMAND IF 
WORKING DIRECTORY IS TO BE OTHER THAN HOME DIRETJTORY 



THE ABSENTEE INPUT SEGMENT OFTEN (BUT NEED NOT) HAS logout AS 
FINAL COMMAND 



&attach HAS NO SIGNIFICANCE IN AN ABSENTEE INPUT SEGMENT SINCE 
ALL USER INPUT IS ATTACHED TO absln FILE 



IF THE ABSENTEE JOB CANNOT BE RUN, OR IF IT TERMINATES 
ABNORMALLY, THE SUBMITTER WILL RECEIVE A MESSAGE FROM THE 
SYSTEM 



\ 



ec st^rt_up.ec 

ec start_up.ec 

ec start_up.ec 

ec start_up.ec 



login 
login 
new^proc 
new"proc 



interactive 
absentee 
interactive 
absentee 
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ABSENTEE COMMANDS 



• enter_abs_request, ear (BATCH NEVER LOOKED LIKE THIS!) 

D QUEUES A REQUEST FOR THE CREATION OF AN ABSENTEE PROCESS 

0 USAGE: enter_abs_request path {-control_^args} 
ear weird. absin 
ear weird. absin -restart 
ear trans. absin -time "Friday 9pm" 
ear trans. absin -queue 1 -arguments add sum 

• list abs request, lar 



0 PRINTS INFORMATION ABOUT ABSENTEE REQUESTS 

Q USAGE: list_abs__request {-control__args} 
lar 

lar -q 1 
lar -all 



17-7 



FOl 



ABSENTEE COMMANDS 



cancel_ab8_request, car 

0 CANCELS AN ABSENTEE REQUEST WHICH IS STILL QUEUED 

D USAGE: cancel_abs_request request_id {-control_args} 
car weird. absin 
car trans. absin -q 1 
car -id 202008 



answer 

0 PROVIDES PRESET ANSWER (S) TO QUESTION (S) ASKED BY A COMMAND 
D PRIMARILY FOR USE IN ABSENTEE INPUT SEGMENTS 

II THE ANSWER IS PROVIDED AN UNLIMITED NUMBER OF TIMES UNLESS 
LIMITED BY THE -times CONTROL ARGUMENT 

0 UNUSED ANSWERS ARE IGNORED 

0 USAGE: answer ans {-control_args} command_Iine 
answer yes delete^dir Dir_A 
answer yes -times 2 help send_message 
answer rest help trace 
answer no answer yes -times 2 help trace 
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AREAS FOR ADDITIONAL STUDY 



• ADDITIONAL DOCUMENTATION 



B MPM COMMANDS AND ACTIVE FUNCTIONS (AG92) 



fl help enter_abs__request 



• STUDY TOPICS 

D CONTROL ARGUMENTS 

D -output_f ile , -limit, -brief 



ABORTING OF AN ACTIVE ABSENTEE PROCESS (THERE IS NO "GRACEFUL" 
WAY) 



D DELETE ACCESS TO THE absin SEGMENT 
II DELETE ACCESS TO THE absout SEGMENT 
B CALL OPERATOR 

B SELF PERPETUATING ABSENTEE PROCESSES 
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SOFTWARE CONVENTIONS 



Page 

Command Language Special Symbols . 18-1 

Segment Name Suffixes 18-7 

Suffix Convention 18-9 

Canonical Form 18-10 

set tty Command 18-12 
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COMMAND LANGUAGE SPECIAL SYMBOLS 



• . (PERIOD) 

D SEPARATES COMPONENTS OF AN ENTRYNAME, STAR NAME, OR ACCESS 
IDENTIFIER 

Attest . alpha . cobol 
».».pll 

Student 04.F01 .m 



• (UNDERSCORE) 

D SIMULATES A SPACE FOR READABILITY IN ENTRYNAMES 
ran__num_gen .basic 

a IS NOT AN ABBREV BREAK CHARACTER 

I ALL SYSTEM SUBROUTINES END IN 



• > (GREATER-THAN) 

I DENOTES HIERARCHY LEVEL (TOP DOWN) 

0 SEPARATES THE ENTRYNAMES IN A PATHNAME 

>udd>F01 >Student_01 >tools>my editor .pll 
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COMMAND LANGUAGE SPECIAL SYMBOLS 



• < (LESS-THAN) 

0 INDICATES ONE LEVEL BACK UP IN THE HIERARCHY 

II EXAMPLES ASSUMING WORKING DIRECTORY IS >UGld>FED>LJones>tools 



cwd < 

cwd >udd>FED>LJones 
cwd << 

cwd >udd>FED 
pr <start up.ec 

pr >udd>FrD>LJones>start_up.ec 

pr <<TSmith>tools>random 

pr >udd>FED>TSmith>tools>random 



• « (STAR OR ASTERISK) 



D MATCHES ANY COMPONENT OF AN ENTRYNAME OR ACCESS IDENTIFIER 
(STAR CONVENTION) 

list seg_1.*.* 

list seg_1.»« 

sa r LJones.*.a 
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COMMAND LANGUAGE SPECIAL SYMBOLS 



• ? (QUESTION MARK) 



MATCHES ANY LETTER OF A COMPONENT OF ' AN ENTRYNAME (STAR 
CONVENTION) 



list s???.old.pl1 
list s??.»* 



• = (EQUAL) 



0 IS REPLACED BY THE CORRESPONDING COMPONENT OF AN ENTRYNAME 
(EQUAL CONVENTION) 



fl » (STAR) AND = (EQUAL) ARE SYMMETRICAL IN MEANING 



rename random .gen .pll ordered. = .= 
rename random .gen .pll ordered .gen .pl1 

rename random. data . base =.= 

rename random. data .base random. data 

rename beta my__=.old 
rename beta my_beta.old 

rename *.new.pl1 =.old.= 
rename beta. new. pll beta. old. pll 

add__name **.ec ==.absin 
add_name pl1_pr.ec pl1_pr.absin 
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COMMAND LANGUAGE SPECIAL SYMBOLS 



% (PERCENT) 



IS REPLACED BY THE CORRESPONDING CHARACTER OF A COMPONENT NAME 
(EQUAL CONVENTION) 



0 ? (QUESTION MARK) AND % (PERCENT) ARE SYMMETRICAL IN MEANING 



rename my_old_ed .pl1 %%%ne\ff%%% . - 

rename my__olci_ed .pll my_new_ed.pl1 

rename ????*. data %$%.= 

rename alpha_2.data alp. data 



• ; (SEMI-COLON) 

fl USED TO SEPARATE MULTIPLE COMMANDS IN A COMMAND LINE 
cwd dir__a; list; cwd dir_b;ls 



- (MINUS SIGN) 



D IDENTIFIES CONTROL ARGUMENTS 



list -directory 

dprint -he TSmith -ds MS106 
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COMMAND LANGUAGE SPECIAL SYMBOLS 



• ( ) (PARENTHESES) 



D CAUSES COMMAND ITERATION 



print (A B add) .pll 

print A.pH 
print B.pll 
print add.pH 



sm Student__0(1 3 5).F01 Return to the classroom. 

sm Student__01 .F01 Return to the classroom, 
sm Student__03.F01 Return to the classroom, 
sm Student 05.F01 Return to the classroom. 



rename (A B add). pll (a b Add).pl1 

rename A. pll a. pll 
rename B.pll b.pH 
rename add.pH Add.pH 



create__dir (newXfirst 

create_dir new>first 
create_dir new>second 
create dir old>third 



second) old>third) 
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COMMAND LANGUAGE SPECIAL SYMBOLS 



• [ ] (BRACKETS) 

D DELIMITS ACTIVE STRINGS. (EVALUATED BY ACTIVE FUNCTIONS) 
sm tlast_message__sencier ] Thanks! 

• $ (DOLLAR SIGN) 

D SEPARATES THE ENTRYNAME OF AN OBJECT SEGMENT FROM THE ENTRY 
POINT NAME WITHIN THE OBJECT SEGMENT 

0 DEFAULT ENTRY POINT NAME IS THE ENTRYNAME 



• »• (QUOTES) 

fl SUPPRESSES THE SPECIAL MEANING OF COMMAND LANGUAGE SPECIAL 



add 

add$add 



add$max 
add$max 



SYMBOLS 



rename foo 



(segment name is: ;) 



delete "A B" 



(segment name is: A B) 



delete "A»'»»B»' 



(segment name is: A**B) 



delete A"'»B 



(segment name is: AB) 
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SEGMENT NAME SUFFIXES 



absin ABSENTEE INPUT SEGMENT FOR THE enter_abs_request COMMAND 

absout ABSENTEE OUTPUT SEGMENT CREATED VIA THE enter_abs_request 
COMMAND 

acs ACCESS CONTROL SEGMENT USEFUL TO THE 10 DAEMON 

aim ALM SOURCE SEGMENT 

apl APL WORKSPACE SEGMENT 

archive SEGMENT MANIPULATED BY THE archive COMMAND 

basic BASIC SOURCE SEGMENT 

bind BINDFILE FOR THE bind COMMAND 

breaks BREAK SEGMENT USED BY THE debug COMMAND 

cmdb MRDS DATA MODEL SOURCE SEGMENT FOR THE create__mrds_db 

COMMAND 

V 

cmdsm MRDS DATA SUB-MODEL SOURCE SEGMENT FOR THE create_mrds_dsm 
COMMAND 

cobol COBOL SOURCE SEGMENT 

code ENCIPHERED SEGMENT CREATED BY THE encode COMMAND 

corapin INPUT SEGMENT TO THE compose COMMAND 

compout OUTPUT SEGMENT CREATED BY THE compose COMMAND 

diet WORDPRO DICTIONARY SEGMENT CREATED BY. THE add_dict_words 

COMMAND 

dsm MRDS DATA SUB-MODEL SEGMENT CREATED BY THE create rards dsm 

COMMAND 

ec COMMAND FILE FOR THE exec_com COMMAND 

fortran FORTRAN SOURCE SEGMENT 

gcos SEGMENT IN GCOS STANDARD SYSTEM FORMAT FOR THE gcos COMMAND 

info SEGMENT FORMATTED FOR USE BY THE help COMMAND 

iodt I/O DEVICE TABLE 
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SEGMENT NAME SUFFIXES 



linus LINUS MACRO SEGMENT FOR THE LINUS invoke REQUEST 

list LISTING SEGMENT CREATED BY A LANGUAGE PROCESSOR 

lister LISTER DATA FILE (STRUCTURED) FOR THE process_list COMMAND 

list form LISTER FORMS DESCRIPTOR SEGMENT FOR THE process^list COMMAND 

listin LISTER DATA FILE (ASCII) FOR THE create^list COMMAND 

mbx MAILBOX SEGMENT FOR THE mail COMMAND 

memo DATA SEGMENT FOR THE memo COMMAND 

motd DATA SEGMENT FOR THE print_motd COMMAND 

mrpg SOURCE SEGMENT FOR THE MULTICS REPORT PROGRAM GENERATOR'S 
mrpg COMMAND 

ms MESSAGE SEGMENTS FOR RJE 

pll PL/1 SOURCE SEGMENT 

profile DICTIONARY SEGMENT FOR THE ABBREV PROCESSOR 
qedx MACRO SEGMENT FOR THE qedx TEXT EDITOR 

symbols SPEEDTYPE SYMBOL DICTIONARY CREATED BY THE add_syrabol 
COMMAND 

wl WORDPRO WORDLIST SEGMENT CREATED BY THE create__wordlist 

COMMAND 
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SUFFIX CONVENTION 



• ALL COMMANDS WHICH ONLY WORK ON SEGMENTS HAVING A GIVEN SUFFIX 
WILL APPEND THAT SUFFIX TO ENTRYNAMES TYPED WITHOUT THE SUFFIX 



archive a F,ielcl_work suramary__report 
archive a Field work. archive summary_report 



basic ran_num__gen -list 
basic ran num gen. basic -list 



cancel_abs_request weird 
cancel__abs_request weird. absin 



cobol A_alpha 
cobol A alpha. cobol 



enter_abs_request weird -tm 6-pm 
enter_abs_request weird. absin -tm 6pm 



exec_com A_create add sum 
exec com A create. ec add sum 



fortran array_dot 
fortran array dot. fortran 



indent add 
indent add.pH 



pl1 add -optimize 
pll add.pH -optimize 
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CANONICAL FORM 



MOTIVATION 



D HOW WAS THE FOLLOWING LINE TYPED? 



The only one! 




The onlyBBBB 



The _Bo__Bn Bl__By one! 



he oB_nB_lB_yB_ one! 



or 



or 



one! 



0 COMPARISON OF TWO INTERNAL LINES SHOULD BE BASED ON RESULTINC 
PRINTED IMAGE 



li THEREFORE, ALL INPUT SHOULD BE CONVERTED TO A STANDARD 
(CANONICAL) FORM 



D MULTICS AUTOMATICALLY TRANSLATES ALL TERMINAL INPUT TO 
CANONICAL FORM (UNLESS THE USER REQUESTS OTHERWISE) 



D SHOULD THE USER NOTICE THAT SOME TEXT IS NOT STORED IN THE SAME 
SEQUENCE AS IT WAS TYPED, CANONICALIZATION SHOULD BE EXPECTED 
(FOR EXAMPLE, DURING CERTAIN TEXT EDITING OPERATIONS) 
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CANONICAL FORM 



• CANONICAL FORM 



D OVERSTRIKES ARE STORED IN ASCENDING ASCII ORDER, SEPARATED BY 
THE BACKSPACE CHARACTER 



D EXAMPLES: (B = BACKSPACE, C = CARRIAGE RETURN, N = NEWLINE) 



TYPIST: 
TYPED LINE: 
CANONICAL FORM 



>B<B 

i 

<B>B 



_B<B> 

<B>B 



TYPIST: 
TYPED LINE: 
CANONICAL FORM 



The onlyBBBB 

The only 

The ^Bo_Bn_Bl__By 



TYPIST: 
TYPED LINE: 
CANONICAL FORM 



We see no prob BlemC N 

We see no problem 

WB Be see no problem 
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SEt TTY COMMAND 



• TERN IN AL TYPES 

I HULTICS ATTEMPTS TO RECOGNIZE TERMINAL TYPE AT DIAL-UP TIME 

I EACH TERMINAL TYPE HAS A SET OF DEFAULT I/O MODES 

i TERMINAL I/O MODES AFFECT CHARACTER CONVERSION, DELAY TIMES, 
AND COMMUNICATION LINE CONTROL 



0 MODIFIES TERMINAL TYPE AND/OR MODES ASSOCIATED WITH TERMINAL 
I/O 

1 USAGE: 3et_tty -control^args 

stty -termlnal_type TN300 

stty -ttp ARDS 





stty 



nodes lfecho,fuIldpx 





stty -edit Aj| 
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SET m COMMAND 



• TERMINAL I/O MODES 




1/J 




can, can 



D PERFORMS STANDARD CANONICALIZATION /(DEFAULT IS ON, 



capo , capo 



D OUTPUTS ALL LOWERCASE LETTERS IN UPPERCASE ^<5eFAULT IS O^E. 




Ifecho 



ECHOES AND INSERTS A LINE F EE D^JJ-TH£-^iiS££d^ INPUT STREAM 
WHEN A CARRIAGE RETURN IS TYPED ((DEFAULT IS OFF}) 



0 crecho, "crecho 



D ECHOES A CARRIAGE RETURN WHEN A. LINE FEED IS TYPEDaDEFAULT 



D fulldpx, "fulldpx 



0 ALLOWS TERMINAL TO RECEIVE AND TRANSMIT SIMULTANEOUSLY 



( fTDEFAULT J [S_OEEb 



0 echoplex, ''echoplex 



11 ECHOES ALL CHARACTERS TYPED ON THE TERMINAL (DEFAULT IS OFfJ 
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SET TTY COMMAND 



I edited, "edited 



D SUPP^EgSES PRIMTIMG OF UNPRINTABLE CHARACTERS - LIKE \014 



SM£g&E&SES PRIN 
(tPEF AULT IS o ff) 




tab 




I INS£RTS^.AB§__IN OUTPUT IN PLACE OF SPACES WHEN APPROPRIATE 
DEFAULT IS OFF>> 



0 tabecho, "^tabecho 



I ECHOES THE ApIOBEJUW jUlHBER OF SPACES WHEN A HORIZONTAL 
TAB IS TYPED (^DEFAULT IS OFp 



polltey "polite 



J DOES NOT SEND OUTPUT TOJtHE-IEiMINAL UNTIL THE CARRIAGE IS 
AT THE LEFT MARGIN r<^EFAULT IS OFF)" 



B replay, "replay 

I REPRINTS ANY PARTIAL TMP UT LINE THAT IS INTERRUPTED BY 
OUTPUT. ((DEFAULT IS OFFp 



YOU ARE NOW READY FOR WORKSHOP 
#8 
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TOPIC XIX 



ADDITIONAL COMMANDS 



Page 

Access to the System 19-1 

Storage System, Segment Contents 19-3 

Storage System, Manipulation 19-10 

Formatted Output Facilities 19-13 

Performance Monitoring 19-14 

Debugging 19-15 

Command Level Environment 19-16 

Accounting 19-18 

Absentee Computations 19-19 

Miscellaneous Tools 19-21 
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ACCESS TO THE SYSTEM 



dial, d 



D CONNECTS AN ADDITIONAL TERMINAL TO AN EXISTING PROCESS 



D ANSWERING SERVICE SEARCHES FOR A LOGGED IN PROCESS HAVING THE 
SPECIFIED Person id AND Project id THAT IS ACCEPTING DIAL-UPS 



i SEE THE dial_manager__ SUBROUTINE DESCRIPTION (AK92) FOR MORE 
INFORMATION 



D USAGE: dial dial_id Person_id . Project_id 
d 411 TransProcHSD 



enter, e 
enterp, ep 



0 CONNECTS AN ANONYMOUS USER TO THE SYSTEM 



Q THE enter REQUEST DOES NOT ASK FOR A PASSWORD WHEREAS enterp 
DOES 

Q USAGE: enter {anonymous__name} Project_id 
enterp {anonymous_name} Project_id 
e JDoe FED 
ep JDoe FED 
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ACCESS TO THE SYSTEM 



fl USED TO GAIN ACCESS TO THE SYSTEM 

I USAGE: login Person^id {ProJect_id} {control_args} 
login TSmith 

login TSmith F01 -cpw -ns -modes If echo 
login TSmith F01 -gpw -cdp -ring 5 

login TSmith -force -hd >udd>FED>Kerr 



logout 



0 TERMINATES A USER SESSION 



B USAGE: logout {-control_args} 
logout^bf 
logout -hold 
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ACCESS TO THE SYSTEM 




MAP 





TELLS MULTICS THAT THE TERMINAL IS AN UPPERCASE-ONLY TERMINAL 



MUST BE INVOKED BEFORE THE ACCESS REQUEST (e.g., login) 
(PREACCESS ONLY) 




ALL INPUT IS MAPPED TO LOWERCASE EXCEPT FOR CHARACTERS PRECEDED 
IT~A \ (BACKSLASH) 



0 USAGE: MAP 



D TELLS MULTICS THAT THE TERMINAL IS AN EBCDIC OR IBM 27^1 



MUST BE INVOKED BEFORE THE ACCESS REQUEST (e.g., login) 



USAGE: 029 -OR- 963 
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ACCESS 'TO THE SYSTEM 




CAUSES THE GREETING MESSAGE TO BE REPEATED 



MUST BE INVOKED BEFORE THE ACCESS REQUEST (e.g. login) 




SEFUL IF THE GREETING WAS GARBLED (AS WOULD OCCUR WITH AN 
EBCDIC TERMINAL OR BECAUSE OF LINE NOISE) 



USAGE: hello 
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STORAGE SYSTEM > SEGMENT CONTENTS 



edm 




Q INVOKES A SIMPLE, INEXPENSIVE TEXT EDITOR (A SUBSYSTEM) 

0 USAGE: edm {path} 
edm 

edm add.pll 




D INVOKES A SOPHISTICATED TEXT EDITOR (A SUBSYSTEM) HAVING MACRO 
CAPABILITIES 



B USAGE 1: 

(MANUAL EDITING) 



qedx 

qx 



0 USAGE 2: 

(MACRO EDITING) 



qedx path {optionaI_args} 

qx conv_ft.qedx Random. fortran 
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STORAGE SYSTEM, SEGMENT CONTENTS 



• archive, ac ULIKE SARDINES) 






COMBINES AN ARBITRARY NUMBER OF SEPARATE SEGMENTS INTO ONE 
SEGMENT (THE ARCHIVE SEGMENT) 



Q A MEANS OF ORGANIZING SEGMENTS (IDENTITY OF EACH SEGMENT IS 
PRESERVED) 



SAVES PHYSICAL SPACE BY COMPACTING SEGMENTS TOGETHER 



1 THE ARCHIVE SEGMENT MUST HAVE A SUFFIX OF archive 



0 CONSTITUENT SEGMENTS ARE CALLED COMPONENTS OF THE ARCHIVE 
SEGMENT 



1 THE COMMAND IS ALSO USED TO EXTRACT COMPONENTS FROM THE ARCHIVE 
AND RETURN THEM TO INDIVIDUAL STORAGE SYSTEM SEGMENTS 




i z 5 



\ USAGE: archive key path components 



ac r bound_pl1_prgms.s add. pi 1 sub.pll 
ac rd bound_pl1_prgms.s [segs •*.pl1] 
ac X bound_pl1_prgms.s .archive sub.pll 
ac t bound_pl1_prgms.s 
ac d bound pll prgms.s add.pH 
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STORAGE SYSTEM, SEGMENT CONTENTS 




KEY 



I TAB LE OF CONTENTS OPEAmPl LCt. tl, tb, tlb) 

0 APPEND OPERATION (a. ad, adf, ca, cad, cadf) 

fl REPLACE OPERATION (r, rd, rdf, cr, crd, crdf) 

0 JiJPDATE OPERATION (u, ud, udf, Cu, cud, cudf) 

D DELETE OPERATION (d. cd) 



EXTM£I OPERATION (x, xf) 









c 


B 


A 



X.archive 




ac a X A C B 
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STORAGE SYSTEM, SEGMENT CONTENTS 




• bind, bd ^... AND THEY SHALL BECOME AS ONE) 

Q PRODUCES A SINGLE BOUND (PRE-LINKED) OBJECT SEGMENT FROM ONE OR 
MORE UNBOUND OBJECT SEGMENTS 

fl THE OBJECT SEGMENTS TO BE BOUND MUST FIRST BE PLACED IN AN 
ARCHIVE SEGMENT 

0 THE CONTENTS OF THE ARCHIVE SEGMENT ARE THEN "BOUND" TOGETHER 

B USAGE: bind paths {-control_args) 
bd editor mods. archive 




bound_ABC.archive bound_ABC 

bd bound.ABC 
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STORAGE SYSTEM, SEGMENT CONTENTS 



compare_ascii , cpa 

0 COMPARES TWO ASCII SEGMENTS AND PRINTS THE CHANGES MADE TO THE 
CONTENTS OF PATH1 TO YIELD THE CONTENTS OF PATH2 

D THE AMOUNT OF LOOK AHEAD FOR RE-SYNCHRONIZING IS DETERMINED BY 
THE nin^chars AND min_lines ARGUMENTS 

1 DEFAULT min^chars IS 50, DEFAULT mln^lines IS 5 

Q USAGE: compare ascii pathi path2 {inin_chars} {inin_lines} 



CONTAINING DIRECTORY) TO REFLECT THE ACTUAL BIT COUNT OF THE 



SEGMENT 

0 USEFUL ON FILES . LEFT IN AN INCONSISTENT STATE (BY AN ABORTING 
PROGRAM, ETC) 

0 USAGE: adjust_bit_count path {-control_args} 



cpa genun.old.pl1 genum.new.pl1 





SEGMENT (AN ATTRIBUTE STORED IN THE 



abc temp 



abc output file -Ig 
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STORAGE SYSTEM, MANIPULATION 



link, Ik (DON'T CONFUSE WITH DYNAMIC LINKING) 

D CREATES A LINK TO A SPECIFIED SEGMENT OR DIRECTORY 

D THE LINK "LOOKS" LIKE THE REAL THING TO MOST COMMANDS 

I USED TO SAVE PHYSICAL SPACE AND/OR REDIRECT STORAGE SYSTEM 
ACCESSES 



fl FREQUENTLY USED BY A PERSON BELONGING TO SEVERAL PROJECTS TO 
LINK HIMSELF TO A COMMON MAILBOX, start_up.ec, profile, etc. 

D USAGE: link path1^ {path2} 

Xk >udd>FED>Kerr>dev>x__sort >udd>FED>Kerr>tools>sort 

Ik >udd>FED>Kerr>dev>x__sort sort 

Ik >udd>FED>Kerr>dev>x_sort 

Ik ChoiDe_dir]>(Csegs[home_dir]>*»]) 

unlink, ul 

D DELETES THE SPECIFIED LINK ENTRY 

D USAGE: unlink paths 
ul sort 
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link >udd>F01> Student. 07>add add.7 
link >udd>F01>Student.07>seg,2 



LINKING EXAMPLE 2 




link >udd>MMPPyLyon>(start.up.ec Lyon.rnbx) 
link >udd>MMPP»Lyon Pat 
link >udd>WOPS>TSmith Jo^ 



FORHATTED OUTPUT FACILITIES 



0 



m dump_segment 

Q PRINTS A SEGMENT'S CONTENTS IN OCTAL, ASCII, OR BCD 



Q USAGE: dump_segment path {first} {n^words} {-control_args} 
ds prince 400 20 
ds add -bed 



sort_seg, ss 

Q ORDERS~THE CONTENTS OF A SEGMENT ACCORDING TO THE ASCII 
COLLATING SEQUENCE 



SEGMENT IS BROKEN DOWN INTO SEPARATE SORT UNITS DELIMITED BY 
SPECIFIED DELIMITER STRING. SORT UNITS ARE THEN SORTED 



USAGE: sort_seg path {-control__args} 
ss teI_data.old 

ss tel^data.old -delimiter xx -descending 
ss tel_data.old -sm tel_data.new -unique 
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PERFORMANCE MONITORING 



cumulative_page_trace, cpt 



0 ACCUMULATES PAGE TRACE DATA SO THAT THE TOTAL SET OF PAGES USED 
FOR A COMMAND OR PROGRAM CAN BE DETERMINED 



Q USAGE: cumulative_page_trace conmand^line {-control_args} 
cpt add -reset 
cpt -print 



pr Mi JLJL9 



0 PRINTS INFORMATION ABOUT THE EXECUTION OF INDIVIDUAL STATEMENT! 
WITHIN A PL/I, FORTRAN, OR COBOL PROGRAM 



1 PROGRAMS MUST HAVE BEEN COMPILED WITH THE -profile CONTROL 
ARGUMENT 



Q USAGE: profile path {-control_args} 
profile add 
profile add -reset 
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DEBUGGING 



• trace_»tack, ts 

8 PRIKTS THE USEIl'S STACK HISTORY - MOST RECENT FIRST 

0 USAGE: trace_stack {-control_args} 
ts 

ts -depth 5 

• trace 

0 MONITORS CALLS TO SPECIFIED PROCEDURES 

B PROCEDURES MUST HAVE ORIGINATED FROM PL/I OR FORTRAN SOURCE 

B USAGE: trace {-control_args} names 
trace add 
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COMMAND LEVEL ENVIRONMENT 



• line lengt 




0 SETS THE MAXIMUM LENGTH OF OUTPUT LINES 

0 WRAP-AROUND, IP IT OCCURS, IS PRECEDED BY "Xc" 

0 USAGE: Xlne_length naxlength 
11 118 



• ready oCf , rdf 

^ L 

0 TURNS OFF THE READY MESSAGE 

1 USAGE: rcady_off 

rdf 



• ready^on, rdn 

0 PRINTS A READY MESSAGE AFTER EACH COMMAND LINE HAS BEEN 
PROCESSED (THE DEFAULT) 

1 USAGE: ready_on 

rdn 
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COHMAHD LEVEL ENVIRONMEHT 




0 USAGE: general_ready {•control^arg} 
gr -string "DONE MASTER" -set 
gr -string * -call print_messages -set 
gr -string READY -hour : -minute -inc_cost 
gr -control * -set 
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ACCOUNTING 



get_quota, gq 

D RETURNS INFORMATION ABOUT STORAGE QUOTA AND USAGE FOR A 
SPECIFIED DIRECTORY 

I DOES NOT "get" THE USER ANY MORE QUOTA 

I USAGE: get_quota {paths} {-control_args} 
gq dir_A 
gq -long 



0 PRINTS A REPORT OF RESOURCE CONSUMPTION FOR THE CURRENT BILLING 
PERIOD 

8 USAGE: resource_usage {-control_args} 
ru 

ru -long 
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ABSENTEE COMPUTATIONS 



fortran absi fa^ 




h SUBMITS AN ABSENTEE REQUEST TO PEliFORM FORTRAN COMPILATIONS AND 
dprint COMPILER'S OUTPUT 



Q USAGE: fortran_abs paths {-ft_args} {-dp_args} {-abs__args} 
fa array_dot .fortran 
fa array dot -map -copy 2 



D SUBMITS AN ABSENTEE REQUEST TO PERFORM PL/I COMPILATIONS AND 
dprint COMPILER'S OUTPUT 




0 



USAGE: pl1__abs paths {-pl1_args} {-dp_args} {-abs_args) 



pa add.pH 



pa add -optimize -queue 1 -hold 
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ABSEMTEE COMFUTATIONS 



• runoff abs/; rfa / 




Q SUBMITS AN ABSENTEE REQUEST TO PROCESS TEXT SEGMENTS (USING THE 
RUNOFF CONHAND) AND dprint THE OUTPUT 

I USAGE: runoff^abs path {-rf_args} {-ear_arg»} {-dp_args} {-abs^ 
rfa prince. runoff 
rfa prince •in 10 -tm 8pn ->cp 3 

• coboI_abs 

Q SUBMITS AN ABSENTEE REtUEST TO PERFORM COBOL COMPILATIONS AND 

dprint COMPILER'S OUTPUT 

I USAGE : cobol_ab8 paths (coliol^args} (dp^args) (-abs^args) 

ca add.eobol 

ca add •optimize -^ueue 1 -hold 
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MISCELLANEOUS TOOLS 



• calc 



ROVIDE THE USER WITH A CALCULATOR (A SUBSYSTEM) 



Q ACCEPTS FORTRAN-LIKE EXPRESSIONS 



fl pi AND e ARE BUILT-IN VARIABLES 



fl USAGE: calc 
calc 

x=pi » 3.4 »» 2 

3.57 * 2««(x * 10.7)/sin (35.7) 

q 




ENCIPHERS A SEGMENT'S CONTENT ACCORDING TO A KEY SUPPLIED BY 
THE USER 



encode ASKS TWO TIMES FOR THE ENCIPHER KEYWORD 



D ENCIPHERED SEGMENT IS GIVEN A SUFFIX OF code 

0 USAGE: encode path 1 {path2} 
encode blacklist 
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HXSCELLANEOUS TOOLS 



decode 

Q RECONSTRUCTS AN ORIGINAL SEGMENT FROM AN ENCIPHERED SEGMENT IF 

PROPER KEY IS SUPPLIED 

0 decode ASKS FOR THE ENCIPHER KEYWORD 

1 USAGE: decode pathi {path2} 

decode blacklist 

new^proe 

Q DESTROYS THE USER'S CURRENT PROCESS AND CREATES A NEW ONE 

Q EFFECTIVELY THE SAME AS LOGGING OUT AND LOGGING IN AGAIN 

0 ASSUMES THE SAME CONTROL ARGUMENTS THE USER GAVE AT LOG IN 

B USAGE: new^proc {-control_arg) 
new^proc 

YOU ARE NOW READY FOR WORKSHOP 
#9 
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TOPIC XX 



SOFTWARE OVERVIEW 



Page 

The Operating System . 20-1 

System Security 20-2 

Ring Mechanism 20-8 

System Daemons 20-9 

System Libraries and Directories . 20-11 

Application Packages . 20-16 
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THE OPERATING SYSTEM 



• MORE THAN 95% OF THE OBJECT CODE ORIGINATED FROM PL/[ SOURCE 
(1 ,132,000 LINES) 



• LESS THAN 5% OF THE OBJECT CODE ORIGINATED FROM ALM ASSEMBLY CODE 
(226,000 LINES) 



# TOTAL OBJECT CODE OCCUPIES MORE THAN SIX MILLION WORDS OF STORW: 



• HIGHLY STRUCTURED (3300 MODULES) 



# CODE IS PURE, RECURSIVE AND RE-ENTRANT 



• ON-LINE INSTALLATION OF SYSTEM MODULES 



• EXTENSIVE ON-LINE METERING AND TUNING FACILITIES 
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SYSTEM SECURITY 



• **...Multlcs Is properly characterized as the most secure 
comnercial operating system available." 

Prof, Peter J. Denning 

Computer Science Dept. 

Purdue University 

(Computing Europe, July 29, 1976) 



• Multics security architecture is superior to any other 
commercially available system (by 2 to 1 ratio). 

Mitre Corporation Study for 
U.S. Air Force - Sept., 1975 
(USDC Order No: AD-A009221) 



• SYSTEM ACCESS: USER AUTHENTICATION 



0 USER AUTHENTICATION REQUIRED TO LOG IN 



i PASSWORD IS DETERMINED AND CHANGED BY USER, AT WILL (RANDOM 
PASSWORD GENERATION IS AVAILABLE IF DESIRED) 



0 ONLY A NON-REVERSIBLE RESIDUE OF EACH PASSWORD IS STORED 



0 NOTIFICATION OF INCORRECT PASSWORD USAGE 



I LAST LOG IN NOTIFICATION 
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SYSTEM SECURITY 

VIRTUAL MEMORY 

0 INVISIBLE ABSOLUTE MEMORY ADDRESSES 

fl ADDRESS SPACE UNIQUE TO PROCESS 

D RESIDUE CLEARED PRIOR TO PAGE ALLOCATION 

FILE AND PROGRAM ACCESS: ACL (DISCRETIONARY) 

D ACL MECHANISM SEPARATES AND PROTECTS USERS FROM OTHER USERS ON 
THE BASIS OF Person_id AND Project_id 

0 EVERY SEGMENT AND DIRECTORY HAS AN ASSOCIATED ACCESS CONTROL 
LIST 

0 ACL DETERMINES WHO MAY ACCESS A SEGMENT OR DIRECTORY AND HOW 
THEY MAY ACCESS IT 

II AN ACL IS MANIPULATED AT THE DISCRETION OF THE SEGMENT »^S OR 
DIRECTORY'S OWNER 
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SYSTEM SECURITY 



FILE AND PROGRAH ACCESS: AIM (NONDISCRETIONARY) 



AIM (ACCESS ISOLATION MECHANISM) MECHANISM SEPARATES AND 
PROTECTS USERS FROM OTHER USERS ON THE BASIS OF SECURITY LEVEL 
AND THE NEED TO KNOW 



EVERY SEGMENT, DIRECTORY AND USER HAS AN ASSIGNED SENSITIVITY 
(SECURITY) LEVEL AND CATEGORY SET 



0 AIM RESTRICTS SEGMENT AND DIRECTORY ACCESS TO USERS BELONGING 
TO THE SAME CATEGORY SET AND HAVING THE SAME, OR HIGHER, 
SENSITIVITY LEVEL 



SENSITIVITY LEVELS AND CATEGORY SETS ARE ASSIGNED BY THE SYSTEM 
ADMINISTRATOR (UP TO 8 LEVELS AND 18 CATEGORIES) 



USERS CANNOT "GIVE AWAY" ACCESS OR WRITE DATA INTO A LOWER 
SENSITIVITY LEVEL REGARDLESS OF ACL PERMISSIONS 



a AIM IS A SITE CONTROLLED OPTION 



TOP SECRET 



SECRET 



UNCLASSIFIED 



CATEGOR Y 
NATO CIA ^ AIR FORCE NAVY 
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SYSTEH SECURITY 



• FILE AND PROGRAM ACCESS: RINGS (INTRAPROCESS) 

D THE RING MECHANISM SEPARATES AND PROTECTS THE OPERATING SYSTEM 
FROM THE USERS 

D THE RING STRUCTURE IS AN 8 LEVEL (0 THRU 7) 
MASTER-MODE/SLAVE-MODE HIERARCHY 

0 0 - CENTRAL SUPERVISOR (MOST PRIVILEGED) 

D 1 - SYSTEM ROUTINES 

B 4 - NORMAL USER RING 

D 7 - HIGHEST USER RING (LEAST PRIVILEGED) 
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SYSTEM SECURITY 




SYSTEM SECURITY 



If EACH SEGMENT HAS AN ATTRIBUTE WHICH IS A SET OF INTEGERS KNOWN 
AS RING BRACKETS 



d the ring brackets define from which ring(s) a process may read, 
writFTTalL, or Execute that segment 



D EACH PROCESS IS CREATED IN A GIVEN RING DETERMINED AT LOGIN 



A PROCESS MAY TEMPORARILY CHANGE ITS RING OF EXECUT ION BY 
EXECUTING A PROGRAM CALLED A GATE 



0 EXAMPLE: 

0 A DATA BASE IN A LOWER RING THAN A USER CAN ONLY BE 

ACCESSED BY THAT USER VIA AN OWNER WRITTEN "GATE" 

PROCEDURE - REGARDLESS OF AIM AND ACL PERMISSIONS 



0 HARDWARE ENFORCED AT EVERY ACCESS 
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RING MECHANISM 



RING MECHANISM SUMMARY 



WRITE 



READ 



EXECUTE 



WRITE 
BRACKET 



READ BRACKET 



EXECUTE 
BRACKET 



CALL BRACKET 



GATE 
BRACKET 



RING OF EXECUTION 



CORRESPONDING 
PERMITTED ACTIONi 

READ, WRITE, 
EXECUTE <WITH RIN 
CHANGE) 



READ. WRITE. AND 
EXECUTE 



READ. EXECUTE 



EXECUTE (IFAGATI 
ONLY. AND WITH Rll 
CHANGE) 



NONE 



* SUBJECT. OF COURSE. TO ACL AND AIM 
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SYSTEM DAEMONS 



Daemon 

0 A SYSTEM SERVICE PROCESS THAT PERFORMS A SPECIFIC TASK SUCH AS 
PROCESS CREATION, BACKUP, NETWORK CONTROL, PERIPHERAL I/O 

0 LOGGED IN BY THE OPERATOR AND CANNOT "TIME OUT" AS A USER MIGHT 
Backup . SysDaemon 

D A PROCESS DESIGNED TO PRODUCE BOTH INCREMENTAL AND CONSOLIDATED 
BACKUP COPIES OF THE STORAGE SYSTEM 

fl BACKUP IS TO MAGNETIC TAPE 

fl SITE DETERMINES THE FREQUENCY OF THE BACKUPS 
Car cl__Input .Daemon 

0 A PROCESS DESIGNED TO MANAGE THE SYSTEM CARD READER(S) 
10. SysDaemon 

fl A PROCESS DESIGNED TO MANAGE THE SYSTEM'S LINE PRINTERS AND 
CARD PUNCHES 
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SYSTEM DAEMONS 



• Dumper .SysDaemon 

Q A PROCESS DESIGNED TO PRODUCE A COMPLETE BACKUP OF THE STORAGE 
SYSTEM 

• GC OS. SysDaemon 

Q A PROCESS DESIGNED TO AID IN THE SIMULATION OF A GCOS 
ENVIRONMENT ON MULTICS 

I ALLOWS STANDARD GCOS JOBS TO BE SUBMITTED FROM EITHER PUNCHED 
CARDS OR IMCV TAPES 

I 

• Initializer .SysDaemon 

0 THE SYSTEM'S PRIMARY PROCESS. PERFORMS THE FOLLOWING 
FUNCTIONS: 

0 ANSWERING SERVICE OPERATIONS (login, dial, logout, etc) 
B OPERATOR COMMAND SERVICE 

B OPERATOR TERMINAL MANAGEMENT AND MESSAGE ROUTING 

B SYSTEM ACCOUNTING AND ADMINISTRATION 

1 USER REQUEST HANDLING (logout, new^proc, etc) 
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SYSTEM LIBRARIES AND DIRECTORIES 



ROOT 



library^ 
auth_mgint 



systemjibrary.l 
sll 



• COMMAND AND 
SUBROUTINES OF 
THE LOCAL 
AUTHOR-MENTION 
LIBRARY 

• ted, lisp, pascsl 



• HARDCORE OPERATING 
SYSTEM PROCEDURES 

• RELOADED EACH TIME 
THE SYSTEM IS 
REINITIALIZED 



systBm_library_tool$ 
tools 



system control 1 
scl 



666 6666 6 6 6 



60 




• COMMANDS AND SUBROUTINES 
SUBROUTINES USED TO 
ADMINISTER, MEASURE, 

AND MAINTAIN THE 
SYSTEM 

• PRIMARILY OF INTEREST 
TO SYSTEM PROGRAMMERS 



• PLUS MISCELLANEOUS ACCOUNTING, 
LOG, LINE USAGE, PASSWORD SEGMENTS 
AND THE I/O RESOURCE CONTROL 
PACKAGES 
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ROOT 

J_ 





illr_dir 
I 






(NAME - n 


tOCESSEO) 



sy«tam_library_Aandanfl 



} 



• ALLOOMMAMOSAND 
SUBROUTINES PROVIDED 
AS PART OF MULTiCS 



ONE 

DIRECTORY 
PER PROCESS 




• PLUS OTHEII TEMPORARY SEGMENTS CREATED 
ASMEEDEO 



oMr. 
w 


dir iKr 
M 






(PROJECT NAME) 






(USER NAME) | 



xyi(t!Hn_iibrary_unbuf)dM 



666 

II LiMUS^ MRDS. MRP6 



ONE 

DIRECTORY 
PER PROJECT 



ONE 

DIRECTORY 
PER USER 



PERSONAL SEGMENTS 
AND DIRECTORIES 
OF THIS USER 



ROOT 



O 



u> 















systerr>_Ubrary .obsolete 




dumps 




gcos^dir_dir 




experimental 
exi 




system__libraFy_network 



CONTAINS OBSOLETE 
OBJECT SEGMENTS 



• CONTAINS SYSTEM 
DUMPS FOR 
CRASHES, ETC. 



• CONTAINS SYSTEM 
SOFTWARE USEFUL 
FOR HANDLING THE 
GCOS ENCAPSULATION 



• CONTAINS SYSTEM • 
SOFTWARE WHICH 

IS BEING DEVELOPED 

• CONTAINS PROCEDURES 
BEING USED IN PLACE 
OF SYSTEM PROCEDURES 
WHICH ARE FAULTY 



CONTAINS OBJECT SEGMENTS 
FOR NETWORK PROCESSING 



o 



SYSTEM LIBRABIES AND DIRECTORIES 



ROOT 



• CONTAINS THE FIRMWARE 
REQUIRED iV VARIOUS 
PERIPHERAL DEVICES 
(i.t,. TAPE AND DISK 
CONTROLLERS) 



o5n 6 6 6 



• DIRECTORIES AND 
SEGMENTS OF THE 
BACKUP AND I/O 
DAEMON PROCESS 




firmwar* 




dMmon_ 

dir_dir 




dociNiMnttrtioii 
doc 





library ..dir_i 



• SEE NEXTP 



info_Myn«nti 




md .info „MpMiNs 





1 



• INFO SEGMENTS 
FOR THE Nrip 
COMMAND 



• INSTALLATION 
MAINTAlNiO 
info SEGMENTS 



• OTHER USEFUL 
DOCUMENTATION 
DIRECTORIES ANI 
SEGMENTS 
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ONE FOR EACH OF THE 

FOLLOWING. 

iVit«m_ Hbrmry .network 
system _libr ary _ob*of9t8 

* unbundFsd 

tools I 

* hardcore and scD J 

* communication | 

* bos ^ 

* language 



source 
s 



object 
o 



lists 
I 



ooo ooo o55 



bound_fuil_cp_.s.archive 

bound_full_cp_.archiwe 



bound_f ull.cp _.li»t 
(bind listings) 



• THESE CONTAIN ADDITIONAL DIRECTORIES 



libr«rv_dir_djr 
idd 



includs 
inci 



666 



• ALL PL/1 INCLUDE 
FILES 



listin 




/ 


\ 



ooboSooSb 

• CONTAINS PL/1 LISTINGS 
FOR SYSTEM PROGRAMS 

• LOCATED ON A SEPARATE 
LOGICAL VOLUME WHICH 
MAV BE REMOVED 

• CONTAINS 9 DIRECTORIES: 

bos 

languages 
staiKlard 
tools 
obsolete 
comm 
unbundled 
ftetworfc 
hardcore 



APPLICATIOW PACKAGES 



# MULTXCS DATA BASE HAMAGER (MDBM) 

B HULTICS INTEGRATED DATA STORE (NIDS) 
C SUPPORTS NETWORK DATA BASES 
fl A SUBSET OF IDS-II 

1 PROCEDURAL INTERFACE (USER SPECIFIES HOW TO SEARCH) 

0 HULTICS RELATIONAL DATA STORE (NRDS) 
I SUPPORTS RELATIONAL DATA BASES 

I INDUSTRY'S FIRST CONHERCIALLY AVAILABLE RELATIONAL DBN 

0 NON-PROCEDURAL INTERFACE USING ENGLISH-LIKE EXPRESSIONS 
(USER SPECIFIES GOAL OF SEARCH) 

0 SET OPERATIONS ON RELATIONS (I.E. ON FILES): 
S UNION, INTERSECTION, DIFFERENCE 

D BOOLEAN OPERATIONS BETWEEN CONDITIONS FOR SELECTION: 

S AND, OR, NOT 

Q ALGEBRAIC COMPARISONS ON ATTRIBUTES (I.E. ON DATA FIELDS): 
B EQUAL, GREATER THAN, LESS THAN, NOT 

1 BUILT-IN FUNCTIONS 

B dbs, after, before, ceil, eoneat, floor, index, nod, 
reverse, round, search, substrf verify 
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APPLICATION PACKAGES 



• LOGICAL INQUIRY AMD UPDATE SYSTEM (LINUS) 



0 END USER FACILITY FOR ACCESSING RELATIONAL DATA BASES 



a ENGLISH-LIKE EXPRESSIONS 



FIND THE AVERAGE SALARY OF EMPLOYEES IN THE SHOE DEPARTMENT 

avg {select salary 

from employee table 
where dept = "Shoe"} 



Q BOOLEAN OPERATIONS BETWEEN CONDITIONS FOR SELECTION: 
D AND, OR, NOT 

fl ALGEBRAIC COMPARISONS ON ATTRIBUTES (I.E. ON DATA FIELDS): 
B EQUAL, GREATER THAN, LESS THAN, NOT 



0 FIND THE NAMES OF EMPLOYEES WHO ARE EITHER IN THE ADMIN 
DEPARTMENT OR WHOSE TOTAL INCOME EXCEEDS $10,000 

select name 

from eraployee__table 

where dept =; "Admin" I salary+comm> 10000 
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APPLICATION PACKAGES 



1 SET OPERATIONS ON RELATIONS (I.E. ON FILES): 
D UNION, INTERSECTION, DIFFERENCE 



Q FIND THOSE ITEMS WHICH ARE SUPPLIED BY LEVI AND SOLD IN THE 
MEN'S DEPARTMENT 

select item 

frpra supply 

where supplier a "Levi** 

Inter 

select item 

from sales 

where dept s "Hen" 



9 BUILT-IN FUNCTIONS 



Q abs, after, before, ceil, conoat, floor, index, nod, reverse, r< 
search, substr, verify 



3 max, mln, sum, ave, count 



0 PERMITS USER DEFINABLE FUNCTIONS (I.E., MACROS) 
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APPLICATION PACKAGES 

MULTICS REPORT PR0GRA|4 GENERATOR 

B A FACILITY FOR GENERATING FORMATTED REPORTS 



MRPG 




DATA 


SOURCE 




(USER 


(USER WRITTEN) 




SUPPLIED) 




INPUT 




INPUT 




TO 




TO 











MRPG 



GENERATES 



REPORT 
PROGRAM 



CREATES 
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APPLICATIOM PACKAGES 



• WORD PROCESSING (WORDPRO) 



9 A COLLECTION OF FACILITIES FOR ENHANCING THE OM-LIIIE PREPARATION 
DISTRIBUTION, AND MAINTENANCE OF DOCUMENTS 

g CONSISTS OF SUCH TOOLS AS: 
D SPEEDTYPE COMMANDS 
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APPLICATION PACKAGES 



1 compose FACILITY 



.Ma itTitltl! 

.fla SI! %Pa9iNo%-S 




Titi* 






.inl*10 


eoriipoie 

















A.«oinpifi A.compout 



D WORDLIST COHHANDS 

0 ELECTRONIC HAIL COMMANDS 

fl TEXT EDITOR 
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APFLICATION PACICAGES 



I LIST PROCESSING CONNANDS 



Yourordtr 




dfttkliflir 



I 



Youroidtr 
for 20 
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APPLICATION PACKAGES 



ONLINE DICTIONARIES 



> unb > ttandard.dict 







a 




ablfl 




acton 




add 


Mwrdlnt 


Aftar 




wher 




where 




Zoro 



trim wordlist 




frad 
(20,000 WORD 
DOCUMENT) 



frad.iNl 
(5.000 UNIQUE 
WORDS) 



frad.tNi 
(100 POTENTIALLY 
MISSPELLED WORDS) 



TEXT COMPARISON PROGRAMS 



Inserted in B: 



caught 20 
large fish. 
Tomorrow vm 
dimb Mt, 
Everest 



A B Change by B to: 

B7 Punk. 



Dear Mom: 
Today we 
caught 20 
small fsh. 
Tomorrow we 
dimb Mt 
Punk. 



compare_ascii 



D I uear muni: 

Preceding: 

A1 Today we 

A3 large fish 
Changed by B to: 
B4 small fish 



A6 



Everest 
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APPLICATION PACKAGES 

• NuXtles GRAPHICS SYSTEM 
I DEVICE INDEPCMDENCE 

* I USER SEES ONLY ••VIRTUAL GRAPHICS TERNINAL*^ (VGT) 
B EACH DEVICE HAS A "GRAPHIC DEVICE TABLE^^ (GDT) 

S STRUCTURED GRAPHIC OBJECTS 

I SIHPLE ITEHS (LINES, POINTS) COMBINED TO CREATE MORE COMPLE> 

I GRAPHIC OBJECTS MAY BE ••SHARED'* (EX. CREATE A WHEEL ONCE, 
INCLUDE 4 TIMES IN AN AUTOMOBILE STRUCTURE) 

0 ALL ITEMS ARE THREE DIMENSIONAL 

1 OBJECTS MAY BE NAMED 

I OBJECTS MAY BE PERMANENTLY STORED 

I ANCILLARY INFORMATION STORED VITH OBJECT 
I SCALING 
I ROTATION 
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APPLICATION PACKAGES 



B EXTENT 

B INTENSITY 

B COLOR 

B DOTTEDNESS 

B BLINKING 

Q SENSITIVITY TO LIGHT PENS, ETC. 

B EDITING FACILITIES 

B MAY EDIT THE WORKING GRAPHIC SEGMENT (WGS) 
B REAL TIME EDITING AT TERMINAL 

B CONTROLLED BY Multics (ANIMATION, DYNAMIC GRAPHICS) 
fl PERMANENT STORAGE OF GRAPHIC OBJECTS 
B TERMINALS SUPPORTED 



0 TEKTRONIX 4002 
4012 

4013 
4014 
4015 
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APPLICATION PACKAGES 



I ARDS 

I CALCONP 915/1036 (PLOTTER) 
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TOPIC XXI 



HARDWARE OVERVIEW 



Page 

Hardware Description .... 21-1 

System Requirements 21-3 

Configuration Limits & Records 21-5 
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HARDWARE DESCRIPTION 



• LEVEL 68 CENTRAL PROCESSOR UNIT 
fl A MODIFIED LEVEL 66 CPU 

D 36-BIT WORD MACHINE (9 BITS/BYTE, 4 BYTES/WORD) 

0 VIRTUAL MEMORY HARDWARE 

D DIVIDES MEMORY INTO SEGMENTS 

I SEGMENTS CONSIST OF 0 TO 256 PAGES 

fl PAGE =1024 WORDS (1K WORDS) 

D RING PROTECTION HARDWARE 

fl ACCESS ENFORCING HARDWARE 

fl HIGH-SPEED CACHE MEMORY 
fl 2048 WORDS 

fl HIT RATIO GREATER THAN 85% 
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HARDWARE DESCRIPTION 



1 EXTENDED INSTRUCTION SET (EIS) 

0 BLOCK MOVE INSTRUCTION (ENTIRE SEGMENT) 

0 BOOLEAN OPERATION INSTRUCTIONS 

0 PICTURE EDITING INSTRUCTIONS 

II 4, 6, OR 9-BIT ARITHMETIC INSTRUCTIONS 

0 POINTER MANIPULATION INSTRUCTIONS 

Q GCOS MODE (ONE SWITCH) 
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SYSTEM REQUIR£MEMTS 



• A SMALL MULTICS CONFIGURATION 

NUMBER 



fl 68/60 CENTRAL PROCESSOR (CPU) 1 

D WORDS OF MEMORY (K = 1024) 256K 

D SYSTEM CONTROL UNIT (SCU) 1 

D I/O MULTIPLEXER (lOM) 1 

0 FRONT-END NETWORK PROCESSOR (FNP) 1 

D MSU0400 2 MASS STORAGE UNITS (MSU) 2 

fl MTUOnOO MAGNETIC TAPE UNITS (MTU) 2 
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SYSTEM REQUIREMENTS 



• A LARGE MULTICS CONFIGURATION (1 TO 10 GROWTH CAPABILITY) 



NUMBER RATIO 

Q 68/80 CENTRAL PROCESSORS 6 (1:6) 

D WORDS OF MEMORY (M=,1 ,048 ,576) 16M (1:64) 

0 SYSTEM CONTROL UNITS 8 (1:8) 

D I/O MULTIPLEXER (# lOM'S + # CPU'S < 8) 2 (1:2) 

D FRONT-END NETWORK PROCESSORS 4 (1:4) 

D MSU0451 MASS STORE UNITS 512 (1:256) 

C MTU0500 MAGNETIC TAPE UNITS 16 (1:8) 
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CONFIGURATION LIMITS & RECORDS 



MEASURE RECORD SITE KNOWN LIMIT 

NUMBER 457 HIS, PHOENIX 1632 

OF USERS (JUNE •77) (408 USERS » 4 DATANETS) 

NUMBER 6 AFDSC, PENTAGON 7 

OF CPU's (AUG »77) (PORT LIMITATION) 

MAXIMUM 4M HIS, Phoenix 16M 

REAL MEMORY (SEPT »78) (8 SCU's » 512K) 

MINIMUM 192K HIS, CAMBRIDGE 1 92K 

REAL MEMORY (1971 - 1977) (BOOT LIMITATION) 

VIRTUAL MEMORY 256M 

PER PROCESS ' (1024 SDW » s * 256K) 

TOTAL VIRTUAL 19. 4B 

MEMORY (512 MSU»S * 38, COOK) 

NUMBER OF 28 AFDSC , PENTAGON 512 

DISK DRIVES (JAN »76) (CABLE LENGTH LIMIT) 



K = 2»»10 = 1 ,024 

M = 2**20 = 1 ,048,576 

B = 2**30 = 1 ,063,741 ,824 
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MULTICS PROGRAMMERS' MANUAL (MPM) 



Reference Guide Order No. AG91 

The MPM Reference Guide contains general information about the 
Multics command and programming environments. It also defines 
items used throughout the rest of the MPM's and, in addition, 
describes such objects as the command language, the storage 
system, and the input/output system. 



Commands and Active Functions Order No. AG92 

The Commands MPM is organized into four sections. Section I 
contains a list of the Multics command repertoire, arranged 
functionally. Section II describes the active functions. 

Section III contains descriptions of standard Multics commands, 
including the calling sequence and usage of each command. 
Section IV describes the requests used to gain access to the 
system. 



Subroutines Order No. AG93 

The Subroutines MPM is organized into three sections. Section I 

contains a list of the subroutine repertoire, arranged 

functionally. Section II contains descriptions of the standard 

Multics subroutines, including the declare statement, the 

calling sequence, and usage of each. Section III contains the 
descriptions of the I/O modules. 



Subsystem Writers' Guide Order No. AK92 

The MPM Subsystem Writers' Guide is a reference of interest to 
compiler writers and writers of sophisticated subsystems. It 
documents user-accessible modules that allow the user to bypass 
standard Multics facilities. The interfaces thus documented are 
a level deeper into the system thaq those required by the 
majority of users. 



Peripheral Input/Output Order No. AX49 

The MPM I/O manual contains descriptions of commands and 
subroutines used to perform peripheral I/O. Included in this 
manual are commands and subroutines that manipulate tapes and 
disks as I/O devices. Special purpose communications I/O, such 
as binary synchronous communication, is also included. 
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MULTiCS POCKET GUIDES 



Commands and Active Functions Order No. AW17 

This pocket guide presents an abbreviated version of the 
commands and active functions described in detail in the Multics 
Programmers* Manual Commands and Active Functions 
Order No. AG92 
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MULTICS ADMINISTRATORS' MANUALS (MAM) 



Project Administrator Order No. AK51 

The Project MAM is a guide to the operation of programs in the 
project- administration area. The information in this manual is 
of interest not only to project administrators but also to 
accounting administrators (who may function as project 
administrators) and to system administrators (who may function 
in any administrative capacity) . 



Registration and Accounting 

Administrator Order No. AS68 

The Accounting MAM is a guide to the operation of Multlcs 
billing and accounting programs. It is necessary that both the 
accounting and system administrators know how to perform the 
Multics billing operations. 



System Administrator Order No. AK50 

The System MAM is a guide to the overall administration of the 
Multics system. This manual discusses the contents of 

administrative directories and data bases and special user 
identifies (such as the daemons), describes installation 
parameters and system logs, explains the various tasks that are 
the responsibility of the system administrator, and includes the 
commands needed to carry out these responsibilities. Also, the 
functions of the system security administrator are explained in 
the MAM System. 
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PROGRAM LOGIC MANUALS (PLM) 
NOTE: The Distribution of Program Logic Manuals is Restricted 



ALM Assembler 



Carry Facility 



Hardware & Software Formats 



Reconfiguration 



Storage System 



System Dump Analysis 



System Initialization 



System Metering 



System Tools 



User Ring I/O System 



Order No. AN69 



Order No. AN76 



Order No. AN87 



Order No. AN71 



Order No. AN61 



Order No. AN53 



Order No. AN70 



Order No. AN52 



Order No. AN51 



Order No. AN57 



OTHER MULTICS MANUALS 



APL Users' Guide 

BASIC 

COBOL Reference Manual 

COBOL Users' Guide 

DFAST Subsystem Users' Guide 

FAST Subsystem Users' Guide 

FORTRAN Reference Manual 

GCOS Environment Simulator 

Graphics System 

Hardware Diagnostic Aids 

Logical Inquiry and Update System (LINUS) 

Multics Integrated Data Store 
Reference Manual 
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Order No. AK95 
Order No. AM82 
Order No. ASMil 



Order No. ASil3 



Order No. AT59 



Order No. AU25 



Order No. AT58 



Order No. AN05 



Order No. AS40 



Order No. AR97 



Order No. AZ49 



Draft 
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OTHER MULTICS MANUALS 



Multics Relational Data 3tore 
Reference Manual 



New Users* Guide 



Online T&D Reference Manual 



Operator's Handbook 



PL/I Language Specification 



PL/I Reference Manual 



Processor Manual 



SORT/MERGE 



Site Preparation Manual 



System Summary Description 



Virtual Memory 



WORDPRO Reference Guide 
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Order No. AW53 
Order No. AL40 



Order No. AU77 



Order No. AM81 



Order No. AG94 



Order No. AM83 



Order No. AL39 



Order No. AW32 



Order No. DC 7 9 



Order No. AK15 



Order No. AG95 



ORder No. AZ98 
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HELP MANUALS 



• THE MULTICS TECHNICAL MANUALS ARE LISTED BELOW. ALL 
MANUALS/UPDATES THAT SPECIFY A DATE IN THE DATE COLUMN CAN BE 
ORDERED FROM THE DISTRIBUTION CENTER; FOR INFORMATION ABOUT HOW 
TO ORDER MANUALS TYPE: 

help order manuals 



IF THE "Date" COLUMN DOES NOT CONTAIN A DATE FOR A MANUAL, THAT 
MANUAL IS "IN PROGRESS;" WHEN A DATE IS SPECIFIED, YOU CAN ORDER 
IT. 



• PROGRAM LOGIC MANUALS (PLMS) ARE LISTED SEPARATELY, AFTER THE LIST 
OF CUSTOMER MANUALS. MARKETING DOCUMENTS (E.G., BROCHURES, 
PRODUCT BRIEFS, ETC.) ARE NOT INCLUDED. 



THIS MANUAL LISTING WAS CURRENT AS OF JULY 23, 1979 



Order 
Number 


Rev . 


Add. 


Through 
Release 


Date 


Title 


CUSTOMER 


MANUALS 








+AG90 


-01 






05/73 


MPM - Introduction 


AG91 


-02 




7.0 


03/79 


MPM - Reference Guide 






A 


8.0 






AG92 


-02 




5.0 


01/77 


MPM - Commands and Active Functions 






A 


6.0 


11/77 








B 


7.0 


02/79 








G 


7.0a 










D 


8.0 






AG93 


-02 




6.0 


02/78 


MPM - Subroutines 






A 


7.0 


12/78 








B 


8.0 






AG94 


-02 




5.0 


07/76 


PL/I Language Specification 






A 


6.0 


10/77 








B 


7.0 


12/78 








C 


8.0 






+AG95 


-00 






06/72 


Virtual Memory 
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HELP MANUALS 



AK50 


-01 





5.0 


10/76 






A 


5.0 


03/77 






B 


6.0 


03/78 






C 


7.0 


10/78 






D 


8.0 




AK51 


-01 




4.0 


08/76 






A 


6.0 


04/78 






R 

o 


7 . n 








c 


8.0 




AK92 


-02 





7.0 


03/79 






A 


8.0 




AK95 


-01 




7.0 


03/79 




-02 





8.0 





AL39 


-00 







04/76 




-01 


A 





09/76 


AL40 


-01 









6.0 


07/77 




-02 





8.0 




AM81 


-01 





6.0 


10/77 






A 
n 


6.0 


01/78 






B 


7.0 


02/79 




-02 





8.0 




AM 82 


-00 





1.0 


02/74 


AM 83 


-00 





4.0 


06/76 






A 


7.0 


09/78 




-01 





8.0 




AN05 


-01 


— - 


7.0 


10/78 


AN50 


-01 





7.0 


03/79 




-02 





8.0 




AN52 


-01 





7.0 


02/79 


AN76 


-01 





7.0 


11/78 






A 


7.0 


12/78 


AR97 


-01 


-— — 


6.0 


07/78 






A 


6.0 


11/78 


ASilO 


-00 




6.0 


10/77 




-01 





8.0 




AS43 


-01 




5.0 


12/76 






A 


6.0 


04/78 






B 


7.0 


02/79 






C 


7.0b 




AS44 


-01 





5.0 


12/76 






A 


6.0 


10/77 






B 


7.0 


01/79 






C 


7.0 


05/79 






D 


7.0b 




AS68 


-00 




4.0 


11/76 






A 


7.0 


01/79 






B 


8.0 




AT58 


-01 




5.0 


02/77 






A 


6.0 


11/77 






B 


7.0 


06/78 



A 



MAM - System 
MAM - Project 

MPM - Subsystem Writers* Guide 
APL Users» Guide 
Processor Manual 

Introductory Users» Guide 
Programmer's Introduction to Multics 
Operators » Handbook 



BASIC 

PL/I Reference Manual 

GCOS Environment Simulator 
Index to Multics Manuals 

System Metering 
Carry Facility 

Hardware Diagnostic Aids 

Graphics System 

COBOL Users' Guide 

COBOL Reference Manual 

MAM - Registration and Accounting 
FORTRAN 
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CC92 


-00 




7.0 


10/78 






A 


8.0 




CC96 


-01 




7. OTP 


06/79 


CG18 


-00 




7.0 




CG40 


-00 




7.0a 




CG41 


-00 




8.0 




CH23 


-00 




8.0 




CH24 


-00 




8.0 




CH25 


-00 




8.0 




CH26 


-00 




8.0 




CH27 


-00 




8.0 





DFAST Subsystem Users' Guide 
FAST Subsystem Users' Guide 

Online Test and Diagnostics Reference Manual 
MPG - Commands and Active Functions 
SORT/MERGE 

Relational Data Store (MRDS) Ref. Manual 
MPM - Peripheral Input/Output 



System Programming Tools 

Logical Inquiry and Update System (LINUS) 
WORDPRO Reference Manual 

Bulk Input/Output 

Report Program Generator (MRPG) 
FORTRAN Users' Guide 

MAM - Resource Control Package (RCP) 

MAM - Communications 

MPM - Communications I/O 



Transaction Processing 

Remote Batch Facility (Lev 68/Lev 6)(Prelitn) 
qedx User's Guide (Preliminary) 
compose User's Guide 
Debugging User's Guide 

New User's Introduction to Multics - Part I 
New User's Introduction to Multics - Part II 
Error Messages 
emacs User's Guide 
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HELP MANUALS 



PROGRAM LOGIC MANUALS 



AN51 
AN53 
AN57 
AN61 

AN63 
AN69 
AN70 
AN71 
AN80 
AN85 
AN87 



-00 
.00 
.00 
■00 

■00 
• 00 
.00 
-01 
-00 
■01 
-00 



5.0 
6.0 



7.0a 



02/75 
06/75 
05/77 
07/74 
09/78 
02/75 
02/75 
02/75 
04/77 



07/76 



System Tools 

System Dump Analysis 

User Ring Input/Output System 

Storage System 

ALM Assembler 

Message Segment Facility 

System Initialization 

Reconfiguration 

Library Maintenance 

Communications System 

Hardware & Software Formats 



NOTES 



* A line has been deleted since the last time this segment was updat 

i This line has been modified since the last time the segment was up 

+ Some of the information in this manual is obsolete 

MPM Multics Programmers* Manual 

MAM Multics Administrators' Manuals 

MPG Multics Pocket Guide 
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MULTICS TECHNICAL BRIEFS 



Page 

Level 68/Distributed Processing System B-1 

Distributed Processing System: Multics Overview B-7 

Multics Virtual Memory and Storage System B-13 

Administration and Operating Features B-1 7 

Interactive Programming Environment B-21 

Controlled Sharing and Security . B-25 

Multics PL/I B-27 

Multics APL . . . , B-29 

Multics Data Base Manager B-31 

LINUS B-37 

Word Processing System WORDPRO B-39 

Multics Graphics System . . B-43 

Multics Electronic Mail Facility B-45 
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Honeywell 



SERIES 60 (LEVEL 68/DPS) 



Level 68/ Distributed 
Processing System 




Honeywell's Level 68/Distribute(i Processing Sys- 
tem (DPS), with the Multics operating system, 
offers the user many powerful features, including 
virtual meitiory addressing, controlled access to 
data, modular design, and advanced segmentation 
concepts that simplify processing. The Level 68/ 
DPS possesses capabilities that enable large-scale 
computer users to solve complex processing 
problems quickly and easily. 

The Level 68/Distributed Processing System con- 
sists of a base system to which performance mod- 
ules can be added in incremental steps, thus offer- 
ing a choice of various levels of performance. This 
easy expansion allows a user to configure the 
exact system needed and helps protect equipment 
investment. 

VIRTUAL MEMORY 

Level 68/DPS virtual memory efficiently and auto- 
matically moves information between main memory 
and secondary storage - independent of hardware 
configuration and without programmer intervention. 
Thus, programs are not constrained by main mem- 
ory limitations and no overlays are required. Fur- 
thermore, user I/O can be handled logically, without 
concern for physical addresses. Integration of the 
68/DPS storage (file) system with virtual memory 
addressing forms a powerful data handling capabil- 
ity, allowing programmers to directly access more 
than 300 billion bytes of stores information. 

SECURITY 

Level 68/DPS hardware and software systems are 
structured for maximum data security. With simple 
commands, access to files can be granted to spe- 
cific persons or groups. Different access rights 
(e.g., read only, execute, write, or combinations of 
these) can also be granted to different users of the 
same file. 

Within the central processor, a hardware mechanism 
maintains the integrity of several levels, or rings, of 
access controls. These rings of protection limit 
access to sensitive data and permit the creation of 
closed subsystems that are mutually exclusive and 
mutually protected. 




Since hardware enforces the basic 68/DPS 
security mechanisms, very little system overhead 
is introduced by access control enforcement. After 
the initial access to a file and on every memory 
access, hardware compares the attempted access 
against the user's permission. Thus, no additional 
machine instructions are executed for security. 

MODULARITY 

The modular design of the Level 68/Distributed 
Processing System has significant advantages for 
processing flexibility and for system growth. The 
optimum combination of processor, memory, and 
input/output multiplexer modules can be selected 
for each installation, integrated Network Proc- 
essors, mass storage subsystems, and peripherals 
are additional modules that can be added to tailor 
a configuration. A Level 68/DPS system supports 
up to 16 million bytes of memory (four million 
words) and employs two or more processors for 
maximum availability. Memory can he added in 
increments of one million bytes up to four million 
bytes. Beyond this level, memory may be added in 
increments of two million bytes. 



S> 1978, Honeywell Information Systems Inc. 
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This approach allows a site to purchase equipment 
for today^s processing needs and add modules to 
meet a growing data processing workload. Furthe^ 
more, each configuration can be given the proper 
max of processing, storage, and I/O capacity, and 
modified as necessary to meet changing workload 
characteristics. Re^rdless of the configuration 
selected, the full functionality of Multics is avail- 
able. Any program that can run on the largest sys- 
tem can also run on the smallest, and vice versa. 

Atiother significant advantage of Level 68/DPS 
modular architecture is the capability for con- 
figuring fully fail-safe systems. TWs is accom- 
plished by including additional system control 
units. I/O multiplexers, network processors, and 
appropriate peripheral subsystems. Note that it is 
not nece^ary to add processor modules since 
Level 68/DPS always contains at least two. 

PROCESSOR MODULE 

The Level 68/DPS processor module executes pro- 
grams and handles all computations. For example, 
it performs instruction fetching, relative and abso- 
lute address preparation, memory protection, data 
fetching, and data storage. These functions are 
overlapped for quick instruction execution. 

Other features of the processor include: 

• Hardware for handling segmentation and paging 
in virtual memory 

• Hardware for interrupting a process in execution 

at any point (including in mid-execution of an in- 
struction), saving processor status, and restoring the 
process later without loss of continuity 

• I ligli-spccd caclic memory for improved perform- 
ance 

• Hardware for enforcing several modes of memory 
access 

• Hardware for implementing data integrity and 
security mechanisms 

• AssiK-ialive memory for fast hardware access lo 
virtual memory 

• Program-addressable registers for preparing virtual 
memory uildresses 



Processor Oi^nization 

The Multics processor module is or^nized around 
functional units 

• Control Unit prryvidet the mterface between 
the C)peration« XUiW »nd the %i%itm controllers 

• OperaiUms Unit Contains the logic to execute 
binary arithmetic and logical functions 

• Decimal Unit - includes an Extended Instniction 
Set (EIS) within the processor's basic repertoire of 
instructions, including instructions for processing 
character string, decimal data, and bit strings 

• Appending Unit - implements segmentation and 
paging of the virtual memory ; provides 24-bit ad- 
dressing; contains 16 segment descriptor words and 
16 page table words on a most recently used basis; 
and provides a descriptor segment base register, 
eight segment pointer registers, and ring protection 
hardware 

• Cache Memory Unit - holds the most recently 
used information from main memory and improves 
system performance by reducing instruction and 
data fetch time 

Processor Modes of Operation 

The processor operates in three modes: absolute, 
privileged, and nonprivileged. All instructions are 
available in the absolute mode. Privileged instruc- 
tions, such as those that operate on the descriptor 
base register and input/output devices, are avail- 
able only in absolute and privileged modes. Most, 
but not all, of the instructions are available in non- 
privileged mode. General users are restricted to the 
nonprivileged mode and thus are prevented from 
executing any instructions that could interfere with 
other programs or with the Multics system software. 

The full segmentation and paging capability of the 
processor is used in the privileged and nonprivileged 
modes for fetching instructions and operands. Ad- 
dressing in the absolute mode does not use the seg- 
mentation and paging capability and is not generally 
available to user programs. 

Segmentation 

Segmentation divides the user's address space into 
many parts and assigns attributes (access control 
and length, for example) to these parts based on 
their logical use. Like a conventional file, a Multics 
segment is a collection of instructions or data s|X'c- 
ified by the user. It has a symbolic name aiul access 
control list and can vary in length. A segment can 
be addressed directly, as memory can, and does not 
have to be read or written record-by -record as a 
conventional file would. 

The segment is the basic unit of information shar- 
ing. Different users can incorporate a single segment 
into their programs merely by specifying Ihc seg- 
ment name. A program doesn't need to copy a seg- 
ment to use it, saving time and eliminating dupli- 
cation in main memory. To control this sharing. 
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each segment has an access control list containing 
the name and access privileges of each person who 
can use the segment. The hardware checks these 
access privileges on each reference to a segment by 

any user. 

Certain segments, containing only instructions 
or constants, are especially easy to use and 
efficient in occupying storage space. These "pure- 
procedure" segments store their data and control 
variables separately. Pure procedure segments do 
not modify themselves; they are also totally re- 
entrant. More than one user can use the same re- 
entrant procedure simultaneously without having 
to copy it. This enhances sharing and saves storage 
space. The Multics operating system, compilers, 
and application programs all utilize pure procedure. 
The major benefits of segmentation are: 

• Stored data and procedures can be referenced 
easily and directly , 

• Logical units such as programs and data are pro- 
tected by hardware 

• Users can directly share procedures and data 
bases 

Paging 

Segments can be of different sizes, and their sizes 
can change during the operation of a program. In 
order to simphfy allocation of main memory, each i 
segment is divided automatically into fixed-size 
storage units called pages. This division - and the 
subsequent manipulation of the pages - is totaUy 
transparent to the user and requires no action on 
the user's part. In addition, any access controls 
established for a segment apply to the pages that 
make up that segment. 

The pages of a given segment need not be located 
in contiguous storage blocks. They do not even have 
to be in main memory all at once. As a page is 
needed in main memory, it is retrieved automat- 
ically from secondary storage and placed in any 
available block in main memory. When main mem- 
ory is filled and more pages are needed, some pages 
have to be displaced. Pa^s not used recently will 
be moved (swapped) to secondary storage. (For 
added system efficiency, pages that are part of a 
pure-procedure segment or have never been written 
into do not have to be swapped out, since a copy 
still exists in secondary storage. These blocks of 
memory can simply be cleared and overwritten 
with other pages.) 

paging has distinct advantages: 

• A user can write and operate a program without 
planning for its storage allocation needs or for the 
management of the segments. 

• Paging provides a simplified technique for dy- 
namic storage management and reduces operating 
system overhead by allowing optimum loading of 
main memory and avoiding compaction problems. 



• Paging uses the system's high-speed storage ef- 
fectively by fetching only pages that are actually 
referenced, rather than an entire program or file. 

Ring Structure 

The Level 68/DPS ring structure extends the con- 
cept of a two^tate machine (i.e., master-mode and 
slave-mode) to a multi-state machine. Level 68/DPS 
provides eight states of execution with adequate 
tools to allow proper administration of access privi- 
leges to the system users within them. This imple- 
mentation allows segments to be grouped into rings. 
The number of each ring (0-7) designates the level 
of privilege assigned to procedure segments executed 
in that ring. Ring 0 has the highest level of privilege. 
Privileged ring segments, such as the supervisor and 
special user subsystems, are protected from uncon- 
trolled use by less privileged rings. These segments 
can only be used by procedures in less privileged 
rings if called via a special ''gate** mechanism. The 
access permission checking is still required as well. 

The ring structure, with its obvious applications to 
information protection and security, is an integral 
part of the paging and segmentation hardware. The 
ring structure offers users numerous benefits, for 
example: 

• Users can create protected programs and data 
bases for controlled use by others 

• A supervisor program can be implemented in 
layers with differing degrees of privilege 

• A programmer can debug a program in an unpriv- 
ileged environment and then move it to a privileged 
environment with no recompilation or modification 

SYSTEM CONTROL UNIT 

The system control unit (SGU) is the principal inters 
face between all central system components. It pro- 
vides complete system interrupt control which 
regulates communication between components and 
services all demands on memory under priority con- 
trol. The system control unit handles the switching 
of all control signals, addresses, and data into and 
out of the memory units. Memory units are modular 
and each connects directly to a system control unit. 

Up to eight system control units may be configured 
in a Level 68/DPS system, with each ECU capable 
of controlling one mega word (four megabytes) of 
memory. However, note that maximum memory 

size currently available is four megabytes. 

Additionally, the SCU checks integrity on all data 
and control paths to and from memory units as 
well us the paths to and from the other system 
components. It also provides memory configuration 
switching. 

The system clock within the SCU a 52-hil binary 
counter that increments at onc-microfccond inlcr- 
vals is Used as a calendar clock. Tlie 142-year 
capacity of the clock makes it possible for Mutticx 
software to operate on a consistent time base. 
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MEMORY 

The metal-oxide semiconductor (MOS) memory of 
the Level 68/nPS Systems can range from 5 1 2K 
words to four miiHon words. Two words, phi's F.rror 
Oetectiofi iml CrttfectJoti (FDACI bih. life m-e^^^d 

INFU I/OUTPUT MUtTIPLtXEB 

Tlie input/output multiplexer (lOM) interfaces the 
system control units with the peripheral units and 
integrated network processors. The lOM can operate 
many different types of devices. It is controlled by 
information stored in memory. 

The lOM can transfer data between I/O devices and 
memory while processors continue to run programs. 
I/O transactions are controlled by lists of control 
words prepared by the Multics operating system and 
stored in memory. When an I/O transaction is com- 
plete, or when special conditions are detected, the 
lOM causes a program interrupt. 

The lOM has attractive performance characteristics: 

• Peak lOM transfer rate of more than four million 

bytes per second 

• Up to 56 simultaneously active data channels per 
lOM 

• Peak channel transfer rates of more than one 
million bytes per second 

• Scratchpad storage for control words 

• Eight special channels for specific system functions 

The I DM offers complete memory protection for 
all I/O data transfers. Each data channel functions 
independently, with its own memory assignment. 
Parity is generated and checked on all information 
sent to and from the system controllers and the 
peripheral subsystems. 

PERIPHERAL SUBSYSTEMS 

The Level 68/DPS mass storage subsystem uses the 
freestanding MSP0603 mass storage processor to 
control up to 32 mass storage units. Multiple mass 
storage subsystems can extend the virtual memory 
size to a maximum of 512 mass storage units. Three 
different devices are supported; the MSU0402 
(78 megabytes), MSU0451 (157 megabytes), and 
the MSU0500 (626 megabytes). These devices can . 
be intermixed on the same mass storage processor. 

The MTP0601 Magnetic Tape Processor supports 
the MTU0400, MTUOSOO, and MTU0600 tape 
units. These devices range up to 200 inches per 
second and 1 600 bits per inch. Other peripherals 
include the PRUl 100/1200/1600 ASCII line 
printers ( 1 1 00, 1200, and 1600 lines per minute, . 
respectively), 1050-card-per-minute readers, and 
100- to 400-card-per-minute punches, all undier the 
control of the Unit Record Processor (URP). Up to 
eight individual devices can be controlled by a 
single URP. 



NETWORK PROCESSOR 

The Integrated Network Processor (INP) controls 
all remote terminal interaction with Level 68/PPS 
host system. Connected to the central system vi;i 
an lOM. the Integrated Network Processor provides 
tfi** vrtHrfUH Mttfmm fefHilred Hy thf elrntpfih 

till iiMlug wHi\ liiii hmi mim Uy lit^iiuiMuot^ M^v: 
tasks of mtissage management and message handling, 
the INP frees the host for other processing functions. 
The resources of the central system are called upon 
only when the message is submitted for information 
processing. However, some networking functions 
(e.g., a message switch) can be accommodated by 
the INP without any involvement of the host 
processor. 

TERMINALS SUPPORTED 

Level 68/DPS systems can communicate with var- 
ious types of terminals, including the following: 

Interactive Devices 

Honeywell VIP 7105, 7205, 7705, and 7800 
Teletype Models 33, 35, 37, 38, and 40 

IBM3270 

IBM2741 and 1050 (EBCDIC and Correspondence) 
IBM 1050 
IBM 2780 

Trendata Models 1 000 and 4000 
Datel 30 
Dura 1021 

GE TermiNet 300 and i 200 (up to 1 200 bps both 
half or full duplex) 
Execuport 3 IOC and 320C 
Texas Instruments Silent 700 Series 
Adage Inc. Advanced Remote Display Station 
IMLAC PDS-ID Graphic Display Computer 
Tektronix (graphics devices to 9600 bps) 
DIGl-LogTelecomputer Model 109 
Data Products Portacom 
Cbmputer Devices Incorporated Teleterm 1030 
(including ASCII/ APL models) 1 132, 1 203 
Teleray Model 371 1 

DECGT40 Display Processor, DECwriter 11, 

DECwriter LA36 (300 baud ASCII) 
DEC Graphics Models 1 2 and 1 5 
Hazeltine 2000 (ASCII) 
Delta Data Systems (Alphanumeric CRT up to 

2400 bps) 

Xerox 2700 (Diablo printer with piottinji c;ip;ihilily) 
Anderson-Jacobson Models AJ630 (ASCII), AJ832, 
and AJ841 

Gen Com Systems GSI300 (300 baud ASCI!) sxv.d 
CSC 3000 

Lcar-Siegler A!)M-2 Display Terminal 
ADDS Consul Model 980 
DTC300 Series 
Infoton Vistar/II 
Bedford 575 (Selecterm) 
BeeHive Super Bee 
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Remote Job Entry Devices 

Absentee (batch) prgcessing is supported at the 
central site and at remote sites. Remote batch ter- 
minals such as the Honeywell Model GI 15, Data 
100/78 (using Honeywell Model Gl 15), RNP702, 
IBM 2780, ^ioncywell Level 6, and Mohawk 2400, 
olTcr remote bulk I/O capability and remote job 
entry. 

RECONnOURATION 

The memory modules, central processors, mass 
storage devices, and terminals in a 68/DPS system 
can be reconfigured dynamically, without inter- 
rupting user service. This allows failing devices to 
be removed from processing for maintenance and 
reconfigured automatically following repair. In 
addifion, failing memory pages are automatically 
deallocated whenever a double-bit (uncorrectable) 
error is discovered. Large configurations can also 
be split into smaller separate systems for block 
time processing or testing without service shutdown. 

SYSTEM CONFIGURATIONS 

System configurations can be tailored to user 
requirements. An entry-level configuration consists 
of: 

A Level 68/DPS System Control Unit with 51 2K 

words of memory 

An Input/Output Multiplexer 



An Integrated Network Processor 
An MTP0601 Magnetic Tape Processor with a mini- 
mum of two MTU0500 tape units 
An MSP0603 Mass Storage Processor with two 
MSU0402 Mass Storage Units providing 156 mil- 
lion bytes of storage 
A printer 

An operator console 

A full selection of terminals 

The system can be significantly expanded to a maxi- 
mum complement of equipment: 

Level 68/DPS with power options to 4.3 times proc- 
essing power of entry systems 
8 System Control Units with a total of four million 
words of memory 
2 Input/Output Multiplexers 
4 Integrated Network Processors 
32 MSP0603 Mass Storage Processors :ind 5 1 2 
MSU0500 Mass Storage Units providing 300 bil- 
lion bytes ol storage 

MTP0601 Magnetic Tape Processor and 16 

MTU0600 Magnetic Tape Units (per subsystem ) 

8 unit macro devices (per subsystem) 

An operator console 

A full selection of terminals 



Specifications may change as design improvements are introduced. 
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PERIPHERAL SUBSYSTEM: 



4 NETWORK PROCESSORS (96 LINES RACH) 
16 MTU0600 TAPE UNITS PER SUBSYSTEM 
8 UNIT RECORD PERIPHERALS PER SUBSYSTEM 
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Honeywell Distributed Processing 

System: Multics Overview 



SERIES 60 ( LEVEL 68/I)PS ) 



Multics. Olio ol" Iho most powcrriil iiiui comprehen- 
sive hiijie-sc;ile systems in the world todny, provides 
lieneriil purpose ihifii processing service for users 
ikMlin^i with cluillenginji business ;md scientific 
problems. B;ised on the concept that the computer 
is only ;«s productive ;is it is ;iccessible, Multics offers 
;i bro;id nuige of lectures and capabilities within 
a service-oriented environment and addresses the 
reliability, availability, and system growth iet|uire- 
ments of distributed processing users. 

PROCESSING CAPABILITIES 

Multics is for large and small users ... experts and 
novices. Its total online, interactive orientation is 
ideally suited to a variety of processing activies in- 
cluding: 

BATCH Multics supports both local and remote 
batch processing. Interactive users can submit 
batch i(>bs for execution: batch jobs can also ini- 
tiate other batch jobs, .lobs vvrillen for batch exe- 
cution can also be run nilcraci ively without change. 

Kr.Morr: JOB I^NI KV MuUIcs supports nimi- 
erous devices for remote job entry. These include: 
Mohawk Data Sciences :4t)0, DA TA 100 Model 78, 
IBM 2780, Honeywell Model G-1 15, Honeywell 
RNP702, and several Honeywell Level 6 models. 

TIMI- SHAR1N(; Full time sharing capabilities 
are available on native motle, interactive Multics. 
In addition, two other environments, the Multics 
FAST and DFAS'I' subsystems, provide the user 
with varying levels of time sharing power and proc- 
essing performance. 

TRANS.ACriON PR()(1':SSING Multics trans- 
action processing offers flexibility and .scope un- 
matched in other systems. Terminal oriented, the 
system doesn't require special executive programs 
to numitor terminal input and then to process user 
recpiests in batch. Applications can be written in 
an\ language and ilireclly accessed from any number 
of terminals or batch jobs ... simultaneously ... in 
a completelv shared envinMimefi;. System facilities 
allow interlaces to speciali/ed tlala bases as well as 
concuireiil aecess control, jt'ui nali/alion, recovery, 
and t)nliiie forms geiieiat ion. 



WORD PRO( iiSSlNC; Multics' advanced word 

processing lacilifies include: 

• Powerful text editors 

• Document formatting capabilities 

• I'rror detection tools 

• SPI'I'DI YPI (shorthand lor typists) 

• Online diet ionaries 

• Artwork macros 

• I'Jectronic mail 

rogelhcr, these features enable the Multics user to 
create and maintain error-free documents and pro- 
duce formatted output. 

GRAPHIC PROCESSING A general purpose inter- 
face enables user and application programs to create, 
edit, store, display, and animate graphic material. 
Multics' grapliic features include: 

• Terminal independence 

• Powerful editing capabilities 

• Permanent storage capabilities 

• Sharing subol'jeels and structures 

• Dynamic animalion 

• Local editing 

• Incremental picture updating 

RI'.AL'riMI- PRO(^i:SSING Multics can provide 
real-time response to specified users or jobs (dead- 
line job scheduling, for example). I bus. the system 
is useful in operations control functions such as 
process control monitoring. 

USER ORIENTATION 

Uniform User Interface 

Key among Multics' unparalleled accessibility 
features is its uniform user interface. All the system's 
processing functions from batch to time sharing to 
graphics are available via a single, consistent 
interface. There are no format or execution differ- 
ences between usage types. A program written in an 
interactive environment will run in batch willitml 
conversion or nnxlifhvfion. and vice veisa. Any 
lermiiial adached to the system can, unless specili 
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cally restricted by the system's administrators, 
access any program or feature. 

Also implicit in the Multics environment is the con- 
cept of total compatibility. There are no restrictions 
on languages used to access data bases or files. Pro- 
grammers can develop COBOL applications, for 
example, with certain modules written in other lan- 
guages, and be assured of total compatibiUty and 
cciual processing erriciency. Moreover, data and pro- 
grams associated with one processing dimension 
(e.g., transaction processing) are totally accessible 
from any other dimension. 

Total Online Orientation 

Multics' architecture is oriented directly toward on- 
Une apphcations. Whereas other systems provide 
online capabilities through executive packages, 
Muhics is completely interactive, and does not use 
such packages. As a result, in high-volume trans- 
action-oriented environments where there is sig- 
nificant terminal activity, Muhics provides unique 
advantages over other architectures. 

Total Sharing 

Multics permits the controlled sharing of operating 
system software and libraries, language processors, 
data bases, and user code and data. Even with mul- 
tiple users simultaneously compihng COBOL jobs, 
for example, only one copy of the COBOL compiler 
is in use. And since all Multics language processors 
generate reentrant code, even users' programs can 
be shared without special programming. 

EASE OF USE 

From its inception, Multics has incorporated features 
and capabilities that make it one of the most acces- 
sible and easy-to-use systems on the market today. 

Interactive Orientation of All Facilities 

Every aspect of Multics is online-oriented, including 
the language processors, apphcations, data base man- 
agement tacilities, utilities, administrative tools, and 
metering and tuning capabilities. 

No Job Control Language 

Unlike other systems - which require that the user 
learn a job control language (JCL) prior to running 
a job - Multics provides control functions via a 
standard command processor approach, thus elim- 
inating complex JCL. System commands and rou- 
tines supply the logical branching, conditional exe- 
cution, file system, and 1/0 control required to 
direct a job through simple and complex execution 
paths. Thus, the Multics user need not learn a new 



batch interface, or become a JCL expert to use the 
system for problem solving. 

Flexible Environment Shaping 

Multics matches the computer's processing environ- j 
ment with the user's particular needs. Providing a 
flexible interface, Multics enables users to continue 
using the computer in the way they are accustomed 
even though they are changing to a new system. 
The concept of shaping environments is particu- 
larly beneficial for data processing organizations 
that service many diverse user groups simultane- 
ously. Each group can develop - using standard 
administrative tools specializ.ed interfaces to 
satisfy uniq\ue operating requirements. Typical of 
these tools is the special command processor with 
which users can define their own abbreviations for 
frequently-used command lines or sequences of 
commands, as required. 

EXEC-COM Facility 

With this feature, users can write programs to exe- 
cute stacked command lines. The additional control 
capabihties provided by the HXKC-COM tacility 
allow for logical branching, the maintenance of 
variables, command-level I/O, and conditional exe- 
cution. Thus, it is possible to develop routines 
for functions which typically require higher level 
languages without having to actually use such 
languages. 

Help Files 

Multics help files contain printed text which pro- 
vides immediate, online assistance to users request- 
ing data on various system topics, including the use 
of Multics commands and subroutines. Tutorials on 
each system feature are thus readily available. Sim- 
ilarly, users can document their own programs and 
routines, and avoid continuous referral to cumber- 
some hard-copy documentation. 

Memo Facility 

The memo facility allows users to indicate when 
specified events are to occur on the system. Lvenls 
to be scheduled can be inter-job signals, mes.sages, 
or program executions. Typical examples include 
simple date reminders and the automatic scheduling 
of an installation's batch applications. 

Intelligent Defaults 

Multics - via its intelligent defaults lets u.sers per- 
form certain functions on the system without having 
to consider concepts that do not pertain to their 
particular application. In a typical situation where 
the user wishes to archive data on tape, numerous 
details such as tape density and blocking factors 
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must also be defined. For users to whom these de- 
tails are not relevant, Multics standard defaults per- 
mit the archive tape to be written via simplified 
I/O routines from command level. 

VIRTUAL MEMORY 

The Miiltics virtual memory implementation, totally 

invisif)k' to iisri pioLMJiins irMNins IIkiI pioj^rammcrs 
c;m c()iicentr;i(c on prohlcni soivinj* r.ilhor llian be 
concerned with real memory constiainfs and mem- 
ory management (e.g., partitions and overlays). 

Virtual nicinory is iimilod only by the amount of 
available mass storage. So, programs written for the 
largest configuration can run on the smallest without 
modification. No standard, fixed main memory-to- 
mass storage ratio is recpiired to ensure efficient 
system operation. Regardless of the ratio, Multics 
can be tuned to perform within its real memory 
constraints, 

Segnientntion 

MuKics orgarii/es inl\)rniati()n into segmcnls 
logical, named units containing data, programs, or 
directories of other segments. The segilients and 
their directories form a uniform file system for all 
users, the administrative and accoimting system, and 
the system software itself. Segments can increase 
dynaniically up to i megabyte in fengfh, and files 
can span nearly 1000 segments. 

Paging 

Multics designers devised the paging concept to 
avoid the system performance limitations that re- 
sult from swapping large files (segments in the case 
of Multics) in and out of main memory. In Multics, 
segments are subdivided into "pages" (4096-byte 
blocks). Address mapping at the hardware level 
enables the system io determine if the page of a 
recpiested segment is in memory and if not, to 
locate (hal page, ti;ins()ort it to memory, ;iiul 
schedule it for execution by the waiting process. 
Demand paging eliminates space allocation and 
compaction problems atul maxinii/es syslen) per- 
formance. Paging is completely transparent to the 
user. .And only tliose pages reciiiired ibr the execu- 
tit)n of a program arc brought inio memory at any 
given time. 

The actual movement of information in and out of 
niain memory is completely automatic anil trans- 
parenl. Data required by the user, lor compulation 
or mampnialion, is retrieved liom peripheral storage 
and inserted in main menu)ry without the user ever 
kntnving ihe transie: u-ok place. 



PROGRAM DEVELOPMENT 

Multics ranks as one of the ijidustry's premiere soft- 
ware development tools. It has powerful source code 
manipulation teclini(iues for entering, editing, and 
archiving code, and for automatically structuring 
programs for easy reading and use. Its online debug- 
ging tools facilitate checking out new code, and aid 
in the fuse tuning oi prognmis. Multics also pri>viiles 
options lor dynamic linking or prcniikmg o\' pro- 
grams, and standard calling sequences for system 
libraries and user programs. 

Multics' fully compatible language processors sig- 
nificantly contribute to the system's outstanding 
program development capability. These processors 
including PL/I, ( 0130L-74, FORTRAN, APL, Al,M 
(assembler), and BASIC can be fully shared. Be- 
cause of their compatibility, programs written in 
APL, for example, can call those written in PL/I 
or FORTRAN. Compatibility is restricted only 
by the data types supported by each language. And 
since all Multics compilers generate reentrant code 
by default, all user programs are shared; no special 
coding procedures are reipiired. 

APPLICATIONS DEVELOPMENT 

During applications development, the programmer 
typically must address concerns such as terminal 
control, data base management, interfaces to system 
functions, data security and integrity, and I/O inter- 
faces. Multics provides a standard applications envi- 
ronment that can be shaped to individual needs. 
Thus, progranuners can avoid these problems and 
concentrate on programming, thereby significantly 
shortening the development cycle. 

DATA BASE MANAGEMENT 

The Multics Data Base Manager (MDBM) offei-s two 
data base management interfaces; Multics Integrated 
Data Store (MIDS), a subset of l-D-S/II;and Multics 
Relational Data Store (MRDS). MIDS supports 
schema/subschema data base definitions to provide 
data and program independence. Data base struc- 
tures which can be developed include setpiential, 
network, hierarchical, or cyclical. MRDS provides 
data and program independence via model/submodel 
data base definitions and nonprocedural user retrieval 
and update mechanisms. Both interfaces allow inter- 
active or batch usage, sharing, concurrent access, and 
access via programs written in any language available 
on Multics. 

ADMINISTRATIVE CONTROL 

A significant strength of Multics is its ability to pro- 
vide service to a wide variety of users simultaneously 
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without the workload of any one group adversely 
affecting that of another. Multics' comprehensive 
set of administrative controls make this high level 
of proceSvSing service possible. These controls include: 

• Decentralized control options 

• Guaranteed resource allocations 

• Priority scheduling with specified response char- 
acteristics 

• Deadline job scheduling 

• Flexible service pricing 

• Automatic or on-demand billing 

• Automatic user or project cut-off when resources 
are expended 

• Online metering and tuning 

• Standard environment shaping 

EASE OF OPERATION 

T\\c operational features in Multics make its utility- 
grade service readily available to a wide variety of 
users. For example, there is no system or library 
generation or edit. The operator can start the system 
simply by typing one command at the console. 
System software and libraries - delivered patch- 
free - can all be updated online. A. new compiler or 
application can be added without shutting the sys- 
tem down, and with only one command, new soft- 
ware can be installed without affecting users working 
with other existing packages. 

Multics can run unattended. An automatic reboot 
feature automatically restarts the system in the 
event of a failure. The system's online test and diag- 
nostic capabilities permit the user to check out a 
malfunctioning component online, remove it from 
service if necessary, and dynamically reconfigure 
the remaining system components ... all without 
irifcrmpting user service. 

I'ilc integrity is iundamental in a service-oriented 
environment. Multics offers automatic mechanisms 
which optionally journalize recent file updates 
within the system's virtual memory. Should a fail- 
ure cause temporary loss of data, these journals can 
be reloaded to continue service. Duplicate file copies 
are not necessary since Multics itself provides file 
backup. 

Additional ease-of-operation features include: 

• Online administration and billing 

• Operation from any terminal 

• Dynamic control of the priority scheduler 

COMPATIBILITY WITH LEVEL 66 

Level 66 and Level 68/DPS systems share a high 
degree of compatibility. In their respective hard- 
ware configurations, only the central processors 



differ. The Multics central processor is a superset of 
the Level 66 unit and has a switch which allows it 
to run Level 66 GCOS, thus providing users of both 
systems added flexibility and backup. 

A special Multics subsystem called the GCOS Fn- 
vironment, allows GCOS job decks or IMCVs to be 
run without change. GCOS files can also be trans- 
ferred between the two systems using standard 
GCOS tapes. 

Multics, through the GCOS Environment, also sup- 
ports several languages that run under GCOS, includ- 
ing JOVLAU ALGOL, COBOL-68, GMAP, and 
FORTRAN-Y. 

DISTRIBUTED SYSTEMS ORIENTATION 

Multics is ideally suited to the development of net- 
works of distributed mainframe systems. With exist- 
ing hardware and software, Multics can be intercon- 
nected with a variety of other systems to form 
networks, that address a broad range of user re- 
quirements. 

With this approach, users establish networks in which 
files, programs, and data can be shared among the 
various systems easily and with maximum security. 
For example, a programmer could log onto an 
IBM 370/158, and then have required data trans- 
mitted from a CDC-7600 to a Multics system for 
processing, with the output going to the 370. Num- 
erous variations of this approach are possible. In 
fact, Multics can currently interface with systems 
such as IBM 360/370s, Burroughs 4700 and 6700s, 
CDC Cybers, and Univac I IOO/90s. 

SECURITY 

Multics offers high levels of security unattainable 
on other systems today. Several elements cooperate 
to make this outstanding system, data, and program 
protection possible. These elements are passwords, 
access control lists, multistate ring protection mech- 
anisms, and access isolation methods. No special 
coding is required to make use of any of these ele- 
ments; only standard system commands need be 
executed. 

Passwords 

The Multics password mechanisms control access to 
the system and verify users' identities. Each user 
has a system-maintained password which can be 
changed at any log-on. Passwords are stored in en- 
crypted form so that a user's password will not be 
revealed accidentally. When the user attempts to 
log on the system, the typed in passworil is en- 
crypted and verified by comparison against the one 
stored in the system. Precautions are taken to en- 
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sure that passwords are not exposed during the log- 
on sequence. 

Access Coiltrol Mechanisms 

All Access Control List (ACL) is used to control 
access to every segment in tiie storage system. 
Through the A( L users can grant specific access 
tights (e.g., leiid, write, execute) to individuals or 
groups of users. System hardware enlbrces access 
control during the executioti of each individual 
machine instruction. 

Ring Protection 

A special hardware implementation, the Multics 
ring stnicture is a multilevel approach to data and 
program access control. The ring structure contains 
eight levels of execution (rings 0 through 7; 0 being 
most privileged, and 7 the least). Within this struc- 
ture, users can access information only in those 
segments at the same level or higher (less privi- 
leged) than the current state in which they are 
executing. The Multics operating system resides in 
the most privileged ring (0) while users generally 
execute in the less privileged rings. 

Access Isolation Mechanism 

The Access Isolation Mechanism (AIM) incorporates 
administrative controls to grant or deny access to 
information in the data base. AIM is a way of organ- 
izing users into groups among which communication 
can be restricted or denied. Like all other types of 
Multics access control, AIM is initially verified by 



Multics software and is hardware-enforced at every 
reference thereafter. However, AIM also can prevent 
iisers from granting - to other users access to 
even their own information. AIM can be invoketl or 
disabled at the discretion of each Multics site. In 
addition to administrative controls, AIM provides 
extensive seciirity auditing controls to monitor user 
activity. 

GROWTH 

Like other Honeywell systems, Multics' hardware 
architecture provides the benefits of modularity 
and an easy, paced growth that does not require 
swapouts to upgrade to higher performance levels. 
This easy expansion allows a user to configure the 
exact system needed and protects equipment 
investment. It is not necessary to change the oper- 
ating system, system libraries, or user codes in 
order to move to a more powerful Multics system. 

SAMPLE SYSTEM REQUIREMENTS 

A typical entry-level Multics configuration consists 
of the following components: 

• Central System, with 5 1 2K words of memory 
(2 million bytes) 

• One System Control Unit 

• One Input/Output Multiplexer 

• One Integrated Network Processor 

• Two MSU0402 Mass Storage Units 

• A minimum of two MTU0500 Magnetic Tape 
Units 
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The MiiKics Sloni^o SyskMii is :i incHliihir, hicrar- 
chicul I'ilc system :iiignicii(ocl hy ;i coinprohensive 
vir luai iiRMiioiy. An iiilcgial component of the 
Miiltics OpiMiiling System, the storage system is 
just another reason why Honeywell believes Multics 
to he the most advanced computer system available. 

HIERARCHICAL STORAGE SYSTEM 

In the Multics System, all inTormation is grouped 
into segments, collections of instructions and/or 
(lata associated with a particular name. All of the 
segments arc slt)red in a tree structured hierarchy 
(see illustration), the beginnmg ol which is called 
the root. The branches emanating IVom the root 
lead to either nondirectory or directory segments. 

The Directory Concept 

The sole junction ol a directory segment is to 
catalog the segments residing below it in the tree, 
l^ach directory contains the names of the subor- 
dinate segments and lists their attributes including 
length, virtual memory address, date and time the 
segment was created, list of users allowed to access 
the segment and with what access mode (read, 
write, execute, or null). 

The directory concept is the key to several Multics 
features, including storage structure, administrative 
control, access control, search rules, and naming 
conventions, l or exaniple, all users registered on 
the system are grouped into projects, luich project 
has a directory, and each u.ser in that project has 
his own directory subordinate to the project direc- 
tory. A user may create additional subordinate 
directories under his own directory or under direc- 
tories to which he has been granted s|)ecilic access, 
lie may also create "links" in his directory to seg- 
ments to which he has specific access. I hia capa- 
bility is often used to share data and/or programs. 

riie Segmentalioii Concept 

All inroriiKition witliin the storage system is stored 
in the form ol segments. Provided the user has the 
proper access rights, all information is directly 
aildressable. In addition, all ol the information 
within the storage .system is placed within tiie 
Multics King Structure (see "Controlled Access 
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to Segments") a hardware-software feature that 
provices maximum security over information 
sharing. 

Each segment is identified by a user-assigned sym- 
bolic name (making use ol" the lull ASCII character 
set) as well as by a unique, system-assigned iden- 
tification. 

Hie fully specified name of any one segment is the 
list of subnames that reflect that segment's posi- 
tion in the directory hierarchy with respect to the 
root directory. Phis name, called a pathname, 
shows the "path" from the root directory to the 
specific segment and is the symbolic name by 
which the user must reference the segment. 

VIRTUAL MEMORY ENVIRONMENT 
Segmentiilion 

In the Multics System, all segments are diiei tly 
addressable by the hardware. Willi the addn'ssini' 
scheme used in the Multics processor, all ii'leieiices 
to information are nia|)pe(l through descri|>lors 
(Segment Descriptor Words). These (lescri|i(ors 
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are listed in y table (Descriptor Segment Table) 
that identifies segment attributes and defines the 
access a user can have to the segments. Most 
importantly, segmentation encourages users to 
view memory as a collection of independent linear 
core memories, each associated with a descriptor. 

A user program can create a segment by issuing a 
call lo Ihe system specifying as arguments the 
symbolic name of the segment plus additional 
information about who may or may not access this 
segment. Then the system constructs a descriptor 
according lo the access information given by the 
originator of the segment. 

The originator has control over every segment in 
his directory; he can grant or restrict access to 
these segments in any way he chooses. In fact, he 
can grant dilYerent access privileges (read, write, 
execute, or null) to different users of the same 
segment. 

Once the segment is created, the user program can 
address any item within the segment using name, i 
where "name" is the symbolic name of the seg- 
ment and "i" denotes the place of the desired item 
within the segment. The maximum segment si/.e is 
25(,K words ( ! ,()48,.S7(> bytes). 

Paging 

With most computer systems, the limiting physical 
resource is main memory. The amount of main 
memory online is a major factor in determining the 
performance of a system. The problems associated 
with "swapping" large files into and out of,main 
memory severely limit system performance. Even if 
files were not all large, there would still remain the 
difficult problem of core management. Since the 
Multics System allows users to create and/or 
manipulate large segments, it is neither feasible nor 
desirable to have an entire segment in main mem- 
ory when in use. 

Therelbre, in the Multics System, segments are 
automatically subdivided by hardware into "pages" 
with a fixed size of 1024 words. Additional address 
mapping at the hardware level allows the system to 
determine whether or not a page of a referenced 
segment is in main memory. 

If the page is not in main memory, a missing page 
exception occurs (called a "page fault"). The 
.software system intervenes at this point and proc- 
esses the page fault by locating tiic desired page in 
the storage system and transferring it into main 
memory. During this phase, the process that gen- 
erated the page lault relinciuishes control of the 
processor and the system dispatches tiie execution 
of another process (process multiplexing). Once 



the page does arrive in main memory, the system 
notifies the "waited" process and schedules it for 
continued execution. 

By using this "demand paging" technique witli a 
fixed page size, space allocation problems are sim- 
plified, and the cost performance factor of the 
system is significantly enhanced: only those seg- 
ment pages that are currently needed are in 
memory at any one time. 

USER ACCESS 
Direct Access to Files 

With m.ost large-scale computer systems, the pro- 
grammer must interface with tiie file system 
througli complicated Job Control Language (.ICL). 
He also must know the specifications of the storage 
device on which his files reside and must issue and 
control (either explicitly or through macro specifi- 
cation) his own I/O requests. 

The Multics System, with the aid of the virtual 
memory, requires no .IC'L, nor are users concerned 
with or even aware of where and on what 
devices their segments reside. Instead, users com- 
municate with the storage sy»item by asking Ihe 
system to tnake available to therri a segniCiil witlun 
their own virtual memory. 

Controlled Access to Segments 

Since all information is stored online in the Multics 
System and data can be accessed directly, access 
limits and controls are mandatory. The access con- 
trol mechanism in the Multics System is a highly 
sophisticated and reliable means for specifying the 
usage attributes of directories and other segments. 
There are two access control lists recogni/ed by the 
system: one for directory segments, one for non- 
directory segments. These access control lists are 
carried in directory segments. 

Access modes for nondirectory segments are: 

read (r) data in the segment can be read 
write (w) data in the segment can be nu)dified 
execute (e) an executing process can transfer to, 

and execute instructions in, this 

segment 

null (n) access to segment is denied 
Access modes for directory segments are: 

status (s) the attributes of segments, direc- 
tories, and links contained in Ihe 
directoiy can be ohlainctl 

modify (m) the attributes of existing segntenls, 
(Ineclories, and hnks conlanicd in 
Ihe directory can be changed or 
deleted 
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append (a) new segments, directories, and links 

can be created in the directory 
null (n) access to directory is denied 

Access validation is checked and cnrorccd at the 
hardware level on each memory reference. Vor 
example, if the originator of a data base decides to 
grant access to some user, he can issue a Multics 
command specifying "read" access for that user. 
If that user is currently attempting to reference the 
data base, he is given access instantly. 

As a further control to accessing segments, the 
Multics System uses the Ring Structure. I^ogically, 
the King Structure is eight concentric rings, each 
representing a different level of virtual memory 
access rights. The highest level of privilege is the 
iruiermosi ring, designateil as ring zero; the outer- 
most is ring 7. l{ach ring is protected against uncon- 
trolled access by programs in any ring with a higher 
number designation and thus a lower level of privi- 
lege. The Multics ring-handling mechanism is 
enforced at the hardware level. 

USER INTERFACE 

In using the Multics Storage System, the user has 
two available interfaces. With the first, the "com- 
mand level" interface, the user can create and/or 
manipulate segments residing in various user direc- 
tories. In many time-sliaring operating systems, the 
command level interface issu[)porled by the 
physical editing o\ the "conunaiid" into various 
system tables in the operal ing system at system 
generation time. With this technique, the problems 
encountered while trying to expand the repertoire 
of the command language can be extreme. 

in the Multics System, however, there is no "com- 
mand language"; every thing executed at Multics 
command level is simply an object program from a 
system directory. When a user types a command at 
his terminal (e.g., create xy/.), the system llrst 
interrogates the user's own directory to see if the 
"create" program exists. If so, that version is exe- 
cuted. If not, the Multics System searches a set of 
syslem/user-supplied directories (called Search 
Directories) for the "create" program. The user 
also has the ability of expanding the default search 
directories to include other directories (possibly 
common to a specific project ). 

The socc)nd user interface is available via program 
execution. Users' object programs can issue call 



statements to create and/or manipulate segments. 
The call statements themselves are of the standard 
PL/I form. Any program executed while at Multics 
command level can be called and executed inter- 
nally from within an object program. 

FEATURES 

Various features of both the Multics Virtual Mem- 
ory and the Storage System are sununari/cd below. 

• All information stored in the Multics Virtual 
Memory is directly addressable provided the user 
has proper access rights. 

• l!stablished protection rings allow users to effcc 
lively partition data within concentric ring struc- 
tures. 

• Two or more users can share a single copy of 
data and/or programs in main memory. 

• Users may create "links" to other accessible 
segments of virtual memory in order to share data 
and/or programs. 

• Each u.ser can specify various access rights to his 
own segments, even specifying different access to 
different users of the same segment. 

• Movement of data between main memory and 
secondary storage and back is automatic, and is of 
no concern to the user. 

• rree-slruclured stt)rage hierarchy offers an 
organized scheme ot classification and facilitates 
efficient search for a particular .segment. 

• Use o\ directories within the storage system 
serves as a convenient place to look up aildresses 
and access rights of other segments. 

• Access rights to a .segment are checked iiy 
Multics hardware on every reference to the seg- 
ment. 

• Multics has no Job Control Language; everything 
executed at conuuand level is merely a standard 
object segment. Thus, the "conuiiand language" 
can be dynamically developed, expanded, ami 
tailored to individual installation even individual 
user requirements. 

SYSTEM CONFIGURATION 

The functions herein described are applicable 
to any Level 68 configuration. 
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Administration and 
Operating Features 



The Level 68/DistribLited Processing Sys|em, with 
its Multics operating system, is an advanced large- 
scale computer system providing general purpose 
data processing service tor business and scientific 
users. 

Level 68/l)PS administration and operating 
I'eatures make its processing capabilities available 
with simplicity and ease. The.se features give the 
Level 68/DPS user more efficient control over 
online applications, improved response to individual 
user and group needs, and optimal utilization of all 
processing-related resources. 

INTERACTIVE ARCHITECTURE 

Lever 68/DPS architecture is specifically directed 
toward interactive, online applications. It provides 
common interfaces for the implementation of these 
applications and for their administration and control 
as well. In addition, special online executives are 
not required to take advantage of these interfaces. 
Level 68/DPS employs standard, built-in tools for 
controlling the use of all system resources. 

MODULAR GROWTH 

Because of the Level 68/DPS hardware modularity, 
its users benefit from a long configuration life span, 
free from disruptive programming or operational 
changes. Level 68/DPS offers growth in small, cal- 
culated steps, paced with the growth of the user's 
workload. Users can add more memory, new proc- 
essors, or front-end networking facilities according 
to specitlc workloads. Level 68/DPS uniformity 
and consistency make it possible to grow from the 
smallest configuration to the largest without 
changing the Multics operating system, libraries, 
or user programs. 

DECENTRALIZED ADMINISTRATION 

I'undamental in the Level 68/DPS design is the 
concept that productivity is tied directly to accessi- 
bility. I'he system's approach to administration is 
consistent with that concept. Level 68/DPS admin- 
istration is decentralized, so that specific resources 
can be allocated to specific projects and accounted 
for accordingly. The project administrator can in 



turn allocate these resources to individual users 
within the project as necessary. 

Allowing remote users and user groups autonomy 
in their use of the system, and enabling them to 
control their own resources, gives them the oppor- 
tunity to more effectively deal with their day-to-day 
problems and varying processing requirements. 

Resource billing flexibility illustrates the advantage 
of Level 68/DPS decentralized administration. This 
billing can be automatic or on demand. Users on 
individual projects can even do their own sub-billing, 
substitute their own billing algorithms, use different 
algorithms for different users, or install new 
algorithms dynamically. 

The Level 68/DPS administrator can establish up 
to eight separate work shifts, with different rates 
appHed to each, encouraging use during slack 
periods. Users can also be restricted to working on 
specified shifts, and these restrictions can be 
changed dynamically. Results: more elTicicnt load 
leveling and more effective use of resources. 

RESOURCE UTILIZATION CONTROL 

Resource control in Level 68/DPS involves three 
primary areas: online storage utilization, physical 
access to system communication lines, and user job 
prioritization. Standard, built-in tools are used in 
each area; 

Online Storage Utilization 

Level 68/DPS enables an administrator to control 
the use of online storage on a "per project" basis. 
To maximize the use of storage resources, tiie 
administrator can allocate this storage to individual 
users v/ithin a project. 

Two techniques illustrate this control: 

• A storage quota, which prohibits tiie allocation 
of storage space when a specified workloati limit is 
reached. 

• An automatic data migration function, which 
allows data to be transferred to another medium 
when that data has not been accessed for a cerlai«i 
period of time. 
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Physical Access 

Controlling the physical access to Level 68/DPS, 
which includes restricting user groups to specified 
communications lines, also means controlling the 
workload mix on the system. The administrator 
can establish the maximum work units that the 
system will acleiiuately support for the particular 
site. Issuing load unit weighting factors lor each 
user ensures that the system's capacity cannot be 
exceeded to the detriment of its users. Different 
users can be issued different weighting factors to 
reflect different processing requirements. To ensure 
that specified privileged or high priority jobs will 
always be executed regardless of the total work- 
load on the system, certain users can be given 
guaranteed access status. 

User Job Prioritization 

Dynamic Scheduling 

User and job prioritization is accomplished via 
dynamic control of the priority scheduler. With 
this capability it is possible, for example, to add 
either more batch jobs or more interactive users to 
a system without negatively affecting the produc- 
tivity of time sharing programmers or transaction 
processing activities already in execution. 

Workload Balancing 

Level 68/DPS also incorporates a workclass concept 
which further ensures that the workload of certain 
users will not negatively affect the workload of 
others. Users can be grouped into classes and allo- 
cated percentages of processing capability. Regard- 
less of the total system workload, each group of 
users can be ensured a predetermined percentage 
of available central processor time, "hree time," 
any time not utilized by a given workclass, is made 
available to other workclasses requiring more than 
their allocated time, maximizing central processor 
utilization. 

Deadline Scheduling 

This feature can be used for a limited number of 
users or applications to ensure that a predefined 
amount of processing time is available to these users 
after an interaction or job submission. Deadline 
scheduling ensures that batch jobs will finish within 
a specified time period, and that interactive users 
will receive a response within a predefined time 
span alter a transaction, regardless of the overall 
system workload. 

Changes to allocated resources, response character- 
istics, and batch job schedulingcan be accomplished 
dynamienlly, or scheduled to happen automatically 
at ;i predcteiiiiiiied tinie. I'or example, a key appli- 
cation can be deadline scheduled so that it is 
ensured a four-second response time during prime 



shift, but only an eight-second response time on 
second shift. 

ENVIRONMENT SHAPING 

Level 68/DPS environment shaping tools lei you 
define interfaces to match users' application proc- 
essing needs. These tools not only make it possible 
for nonexperts to use 68/DPS for problem solving, 
but also enable system administrators to succinctly 
define and limit what users can do with the system 
and what they must know to process their 
appHcations. 

The two major environment shaping tools are the 
limited service subsystem and the closed subsystem. 

• The limited service subsystem enables the project 
administrator to define exactly those functions 
which the user cannot perform: all other system 
functions are available to that user by default. 

• The closed subsystem lets the administrator 
define all the functions which the user can perform; 
all other functions are unavailable by default. 

The limited service and closed subsystems can also 
be used for defining new command languages and 
interfaces that convert "foreign" system commaiuls 
into Multics operating system commands. '\ \m can 
be useful to first-time Level 68/DPS users. In adili- 
tion, these subsystems allow nontechnical usei-s to 
access the system via a highly simplified command 
interface. The capabilities afforded by these struc- 
tured interfaces do not have to be programmed; 
they can be established via simple commands. The 
administrator need only create a new file with tiie 
new restrictions or guidelines in it, and it is immedi- 
ately available to all authorized users. 

SIMPLIFIED SYSTEM OPERATION 

Level 68/DPS is surprisingly easy to operate, espe- 
cially considering its size and power. This relative 
ease of use is due largely to its dynamic reconfigura- 
tion capability, simplified system maintenance, ami 
responsive online metering and tuning capabilities. 

Dynamic Reconfiguration 

The dynamic reconfiguration capability of Level 
68/DPS is used to maintain continuity of processing 
service in the event of a malfunction in a system 
component. If a failure occurs in a processor, for 
example, a single command automatically moves 
jobs and data in that processor to another unit, 
notifies the other system components of the mal- 
function, removes the processor from service, aiul 
reconfigures the remaining ilevices. Processors, 
memory, and peripheral devices can be lulded to or 
deleted from a configuration dynamically, via oiXM 
ator command, l-ailed pages of memory (4K-hytc 
units) are automatically reconfigured by the oper 
ating system whenever a double-bit error occurs. 
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TIlis reconfiguration process can also assist in the 
testing of certain components. Users can 
dynamically remove certain devices from service^ 
submit them to test and diagnostic routines and 
reconfigure them automatically, without inter- 
rupting processing service. Alternatively, devices 
can be dropped from service on one system, con- 
figured as a separate system, used for testing of new 
software, and then reconfigured in the original 
system without shutting down service. ^ 

Level 68/DPS can run unattended, providing proc- 
essing service on holidays and weekends, without 
the need for operators. During unattended opera- 
tion, it can be run in the automatic reboot mode, 
and, in the event of a system failure, the system 
will automatically reinitialize itself so service can 
continue. 

Level 68/DPS can be operated from terminals inside 
or outside the computer room. Due largely to the 
system's extensive security, an administrator with 
the proper authority can log into the system and 
issue any command that could be issued from the 
main operator's console. This gives Level 68/DPS 
greater operational flexibility, and frees it from 
relying on a single device (which might fail) for 
control functions. 

Level 68/DPS provides batch job status and con- 
trol capabilities as well as communication between 
system users. Operations messages can be sent to 
individual users; messages can be broadcast to the 
entire user community or to those on a particular 
project (or vice versa). 

System Maintenance Features 

For simplified maintenance, the Multics operating 
system does not require system or library gener- 
ation or edit. Multics software releases are also 
delivered patch-free. 

Users can easily install their own software or 
add programs to the time sharing library. New 
software can be installed without a system shut- 
down or link-edit. New compilers, applications, 
and procedures can be installed without inter- 
rupting processing service, even while users are 
using old versions. 

Metering and Tuning System Performance 

Level 68/DPS offers standard metering and tuning 
tools that allow an administrator to monitor and 
adjust system performance according to specific 
needs and changing workloads. Using dalu that 
is constantly being gathered by the system itself, 
administrators can retune the system, move users 
from one processing class to another, or oven 
change the percentage of processing power allo- 
cated to a user, depending on any number of 
variables and requirements. 



This control is possible because the administrator 
can analyze all facets of system perforniance fn^in 
this constant flow of metering data. Some of the 
information supplied includes: 

• I/O and device activity data 

• Application response, processor utili/ation, 
communications, and I/O queuing 

• Average CPU time spent on certain functions, 
or used by certain applications 

• State and characteristics of the communicalions 
lines attached to the system 

• EDAC (Error Detection and Correction) data 
associated with main memory hardware erroi-s. 

PRE-SCHEDULED ADMINISTRATIVE 
FUNCTIONS 

A system facility called MEMO provides jzcncr- 
alized capabilities for scheduling tiie initiation and 
execution of any program or set of jirogrunis. This 
allows the administrative or operational staffs 
to pre-schedule the running of administniiivc 
routines, such as billing. Scheduling can he scll- 
repeating, such as scheduling a program to he run 
every Monday at 3 p.m. MEMO also allows cither 
a precise definition of day/date/time (down to a 
microsecond level) or more general, logical 
definition ("on Tuesday"). 

INTEGRITY MECHANISMS 

To maintain file integrity in the event of a mal- 
function. Level fi8/DPS has powerful file back-up 
mechanisms. 

• An automatic file archiver journali/cs ail 
changes to the file system ami makes it possible 
to "roll forward" following a failure. 

• Online file system integrity checks ensine a 
consistent, reliable file system. 

• Main memory fiush-to-disk is an automatic 
data protection mechanism invoked altera system 
service interruption. All data in main memory 
which has been modified is written out to mass 
storage to reflect all changes made up to the CPU 
cycles prior to the failure. 

• Support of optional "shadow copy" logical 
volumes within the storage system. Volumes 
designated to have shadow copies automatically 
have spare devices assigned with copies of each 
physical volume. When updates are made to any 
ofthe.se devices, the copy is updated as well. 

if a device fails, the system automatically shifts 
lo (he copy wilhoul user interrupt. 
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Interactive Programming 

Environment 



To the user, a computer system is only as produc- 
tive as it is accessible. Based on human engineering 
design concepts, the Level 68/Distributed Process- 
ing System (6S/l)PS) uses interactive, remote ter- 
minal access - the most natural and convenient 
mode tor the user - as the primary mode for 
programming. 

With the advent of Level 68/DPS, the computer is 

to be measured, not merely by hardware speeds, 
but by how well it helps solve a problem - from 
the very inception of that problem to its best solu- 
tion. Rather than wait for computer availability in 
a batch mode and submit many sequential jobs, a 
Level 68/DPS user prepares, compiles, and checks 
out programs in one continuous interactive terminal 
session. 

The Level 68/DPS interactive programming environ- 
ment provides a complete range of facilities that 
satisfies both the novice user and the professional 
progranmier. Both enjoy appropriate software tools 
and both can work on the same system, protected 
by advanced hardware/software security features. 

The Level 68/DPS user interface provides an envi- 
ronment for a nearly unlimited scope of applica- 
tions regardless of size, complexity, or storage 
requirements. The multiprocessing, multiprogram- 
ming capabilities of Level 68/DPS and its diversity 
of languages and utility routines provide the user 
with all the support needed. 

THE PROCESS, A UNIQUE CONCEPT 

When first accessing (logging into) a Level 68/DPS 
System, a user is allocated system resources in an 
enviromnent termed a "process." Specifically, the 
process is dynamically assigned space within the 
virtual memory (address space) and other system 
resources as required. As a result, each user views 
his process as if it were the only one in the system. 
In this environment, the user's address space dy- 
namically grows and shrinks as program require- 
ments expand imd contract and the activity is 
totally transparent to the user and under control 
of the shared operating system. The system creates 
a process at log-in time and destroys it at log-out 
time on behalf of each user. The user executes his 



program and system commands in coexistence with 

the processes of all other logged-in users under the 
multiprogramming control of the Multics operat- 
ing system. 

SYSTEM FEATURES 

Some of the more important features of the 
Level 68/DPS interactive programming envi- 
ronment include: 

• Flexibility of enviromnent shaping 

• Information sharing in the Level 68/DPS 
Virtual Memory and Storage System 

• Powerful language processors 

• Extensive support facilities and tools 

• Powerful command processor 

• Protection (security) 

• Special user interfaces 

Flexibility of Environment Shaping 

The administration of a typical U^vel 68/l)PS 
systen'i includes one system administrator anil 
multiple project administrators, l^ach project 
administrator dellnes the working environment 
for users in that project. He may give a user maxi- 
mum flexibility by allowing him complete control 
in creating his own initial process, or he may limit 
the user's capabilities by restricting access to vari- 
ous software functions. 

The project administrator, then, defines the rajige 
of access each user has to system software func- 
tions. If the user has complete control of his own 
process environment, he may change parts of that 
environment and still be within the normal oper- 
ating conventions of the system. 

Information Sharing in the Level 68/DPS Virtual 
Memory and Storage System 

A Level 68/DPS system provides total sharing of 
data between users. In addition to sharing the oper- 
ating system's modules, libraries, language proces- 
sors, and applicaliotis, users can even share user 
code and data. This is possible because all Level 
68/DPS compilers generate pure, reentrant code by 
default. 
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All procedures and data arc contained within the 
Level 68/DPS Storage System and its associated 
virtual memory including I'acilities that provide the 
user with extensive control over I'ile manipulation 
and file sharing. A user can specify which individ- 
uals may access his files, and by which mode of 
access. Access can be given to one user, to a group 
of users (project), or to a particular class of users 
(interactive or batch). 

The Level 68/DPS Storage System is supported by 
a powerful virtual memory, totally transparent and 
available to the user as needed. Virtual memory dy- 
namically expands and contracts according to user 
requirements and system resources. Thus, program- 
mers no longer need to be concerned about over- 
laying or partitioning program modules to satisfy 
limited main memory resources. Instead, they can 
concentrate on program synthesis and on develop- 
ing the most efficient algorithm to solve their 
particular problems. 

Powerful Language Processors 

Level 68/DPS includes several fully compatible lan- 
guage processors. Foremost is a functional PL/I 
compiler that is used for both system programmers 
and applications programmers. The present PL/l 
compiler has undergone several major design iter- 
ations to become perhaps the most stable and re- 
liable PL/1 compiler in existence. This is the same 
PL/1 compiler that is used to produce the Multics 
operating system software itself, 95 percent of 
which is written in the PL/I language. 

Level 68/DPS supports COBOL-74. As with all 
Level 68/DPS compilers, COBOL programs can 
call programs written in any other language, 
thereby offering developers optimal flexibility. 

A complete FORTRAN compiler is available to 

satisfy any FORTRAN requirement as well as to 
facilitate the transfer of software from other com- 
puter systems. 

A BASIC compiler offers quick compilation and 
execution. It can be used as an independent lan- 
guage processor or in the simple time sharing sub- 
system called FAST. 

An APL language processor is also available. 
This is an interactive interpreter with exten- 
sive functionality. 

For users who find it necessary to write portions 
of their software in the language of the host com- 



puter. Level 68/DPS includes the ALM (Assembly 
Language for Multics) assembler. This assembler 
supports all system requirements for intcrprognim 
communication. 

A program written in any language available on 
Level 68/DPS can also call programs wriUen in 
another language by merely following (hat lan- 
guage's calling conventions. For example, AIM. 
functions can call PL/1 procedures. 

All compilers will automatically generate pure, 
reentrant code for users, making all programs 
immediately shareable. 

Extensive Support Facilities and Tools 

Stable and reliable software components within 
the Multics operating system provide numerous 
utility and support functions. Foremost among 
these are the text editors. These text editors have 
undergone several design iterations to increase 
their reliability and sensitivity to human 
engineering requirements. Level 68/l)PS text 
editors range from a simple editor supporting 
line-numbered files to advanced editors lor ex|)e- 
rienced users. 

Several extensive interactive debugging packages 
permit a user to analyze and correct a compiled 
program at both the original source level and the 
more specific machine-register level. 

Tools to measure performance permit the user to 
analy/.e a program's behavior and facilitate the 
development of optimum applications software. 

Inter-user comnumication facilities, both immedi- 
ate and deferred, permit online messages to be 
transmitted among users. In addition, online docu- 
mentation facilities provide the user with useful 
word processing and document preparation tools. 

Powerful Command Processor 

The command processor, by which a user commu- 
nicates his requirements to the' system, accepts 
input from a console, interprets the user's request, 
and invokes the software component to perform 
the desired function. The software component can 
be either system- or user-supplied; there is no dis- 
tinction at the command level. The command 
processor allows recursive, iterative commands 
and the embedding of function calls in the com- 
mand line. 

The command processor is a shared, replaceable 
module, written in PL/1. Therefore, if tiie project 
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administrator desires, a user can be required to 
interface with a special version of the command 
processor (possibly user-created), thereby limiting 
the software requests or commands available to 
him. The command processor thus permits an ex- 
tremely wide range of interfaces to all system fa- 
cilities on either a controlled or open-ended basis. 

Tools are available to the user which allow the ab- 
breviation of commands or character strings for the 
development of personalized shorthand methods 
for directing program execution or accessing files. 

A facility also exists which allows users to program 
in commands with logical branching, variable main- 
tenance, file management, and I/O control. This 
allows the development of complex applications 
witiiout the involvement of language processors. 

The command syntax has been designed to provitle 
as sophisticated and flexible a user interface as any 
user might possibly require for both a commutative 
and associative syntax form. However, simple 
requests have a simple form. 

SUMMARY 

• The Level 68/DPS interactive programming envi- 
ronment provides facilities for both the novice and 
advanced user, for a wide range of applications. 

• The user's virtual memory (address space) 
dynamically changes as program and data 
requirements change. 



• A unique process environment exists for each 
user, and this environment can be reshaped as 
needed. 

• Files are protected by user-spec i lied access 
controls. 

• Level 68/DPS includes several language proces- 
sors: COBOL-74, PL/L FORTRAN^ BASK . AIM , 
and ALM. 

• The support facilities of Level f>8/l)PS inehuie 
text editors, program debugging aids, jierformanec 
measurement tools, inter-user coninuinieation 
facilities, and online documentation aids. 

• The Level 68/DPS command processor allows a 
wide range of interfaces to a|l system faeililies 
either on a controlled or open-ended basis. 

• Included within Level 68/l)PS are special user 
interfaces that permit the developujent ofoilu r 
operating systems, closed subsystems, or limited 
service facilities. 

SYSTEM CONFIGURATION 

The functions described herein are applicable to 
any Level 68/DPS configuration. 



Sivcificutioiis m<iy ciiange us dcsi}!n iiiiprovi'iiionis jiv inlnuhKod. 



Honeywell 



Honeywell Information Systems 

In the U S A. 200 Smith Street. MS 486. Wattham. Massachusetts 021 54 
In Canada. 2025 Sheppard Avenue East. Willowdale. Ontario M2J 1 W5 
In Mexico. Avenida Nuevo Leon 250. Mexico 11 , D.F. 

20936. 2.D578, Printed in U.S.A. AKl>8, Hi>v. 3 



B-24 



Honeywell 



SERIES 60 (LEVEL 68/DPS) 



Controlled Sharing 
and Scxurity 



in today's data processing environment computer 
security is a major concern. News stories tell of 
millions of dollars being stolen; company proprie- 
tary information being sold to competitors; and 
valuable information being deliberately destroyed 
or altered. In addition, there is growing concern 
regarding the protection of individual rights - just 
what type of data can be compiled on an individual 
and how should such information be protected 
from unauthorized disclosure. At this time, laws 
protecting privacy carry both civil and criminal 
penalties. So the processing of sensitive information 
on an insecure system e?tposes companies to loss 
and fraud and, potentially, to civil and criminal 
proceedings. Secure computer systems have become 
a vital concern to the data processing industry. 

SECURITY MECHANISMS 

Level (>8/L)PS is the most secure computer system 
commercially available.' Level 68/l)PS and its 
Multics operating system provide security by a 
combination of methods unique in the industry. 
These methods are designed into, and are an inte- 
gral part of, the functioning of the system. Because 
the security mechanisms are implemented in both 
hardware and software and are applied universally 
to all user and system functions, they are far more 
difficult to subvert and security benefits are 
achieved with insignificant system overhead. 

Initial Access 

Initial access to the Level 68/DPS system is con- 
trolled by means of the user identification and 

password. 

riio password mechanism is the first and most 
important line of security since it controls access 
to the sysloin and verifies the user's itienfity, upon 
which further access decisions are based. To ensure 
that users treat passwords with the care the system 
retpiircs, Multics provides facilities to allow users 
to change passwords easily, to peimit the System 
Security Administrator to compel peri(Klic pa.s.s- 
word changes, and to require users to use systcni- 
generatcil, pronounceable passwords. 

When the system requests the entry of the pas.s- 
word at log-in time, the print mechanism of the 



user's terminal is turned off (if the terniinul Ikis 
this feature) or a mask is printed, over which the 
password is typed. Thus, a password is never dis- 
played in readable form when it is enteretl. 

Passwords arc .stored in encrypted form within the 
system. When a user logs in, the typed password is 
similarly encrypted and the .scrambled values are 
coin pared. 

Multics audits the usage of each password. It also 
counts incorrect passwords and types a message :it 
log-in, telling the user how many limes that pass- 
word has been given incorrectly since its last cor- 
rect entry. This alerts the user to the possibility that 
someone has attempted to guess the pa.sswortl. 

The System Security Administrator can also set an 
entry in the system message table causing a message 
to t)c scfit whenever the u.ser is logged in and some- 
one else attempts to log-in with the same inwnc. 
project, and password. 

Once verified and accepted by the system, the user 
is screened for information sharing (i.e.. the kind 
of access permitted to the file system and to user 
and system software). 

Information Sharing Controls 

Beyond the password control (which screens every 
person attempting to use the system), three adili- 
tional controls regulate access rights to all data anil 
programs in terms of individual users and processes. 
These information controls are access control lists, 
access isolation mechanism, and the ring protection 
mechanism. 

ACCESS CONTROL LIST (ACL) 

The access rights for each segment are defined in its 
access control list (ACL). Through the AC L, users 
can, at their own discretion, grant or deny access lo 
their segments and directories. The ACI. specities 
the users who have been granted access to the seg- 
ment and the mode of access allowed I hem. Usrrs 
who do not appear on the ACI. have no acress to 
the segment. Read, write, execute, (uul null ' per 
mi.s.sions may be s|iecilied lor segments (both tiala 
and program); status, modify, and appeml ai cesses 
may be specified (or file .system directories. I hese 
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pernnissions may be specified by user name, by 
project, or by "instance" (whether a process is ab- 
sentee or interactive), or by any combination 
thereof. Gasses of users can also be specified; for 
instance, all the users in a project, specific users in 
Sf project, or even ail users in ail projects. Access is 
initially verified by Muitic-* software and is enforced 
by the hardware every time the segment is refer- 
enced thereafter. 

ACCESS ISOLATION MECHANISM 

The Access Isolation Mechanism (AIM) allows 
administrators of the system to define several 
levels of privilege, which the system itself en- 
forces rigidly. Enforcing the separation of these 
levels is totally independent of other access 
control or user action. This administrative mech- 
anism overrides user discretion in granting access 
and ensures privacy by preventing inadvertent or 
malicious disclosure of information between 
these privilege levels, even by those who "own" 
the information. 

AIM can be explained in simple terms. At log-in 
time, each process is assigned a sensitivity level 

and category (clearance) based upon the clearance 
of the user, the terminal, and the project. Also, 
every directory and segment (object) within the 
storage system has a sensitivity level and category 
(classification) associated with it. If the clearance 
of a process is equal to the classification of the 
desired object, ail access to the object (allowed by 
other access control mechanisms) is permitted. If 
the clearance of the process is greater than the 
classification of the desired object, read, execute 
or status permissions are allowed to the object 
(within constraints imposed by the other access 
control mechanisms). Finally, if the clearance of 
a process is less than the classification of the de- 
sired object, all access to the object is denied. 

AIM supports 8 clearance and 1 8 "need-to-know" 
categories within each level. Access is granted or 
denied explicitly on the basis of the security classi- 
fication of a file or program and the security clear- 



ance of the user. This mechanism supplements the 
access control lists. Like the ACL mechanism, 
access is initially verified by Multics software and 
thereafter enforced by hardware at every reference. 
AIM can be invoked or disabled at the discretion ot 
each Multics site. AIM also provides extensive secur- 
ity auditing controls to monitor user activity. 

RING PROTECTION 

The Level 68/DPS Security System uses a hardwaa*- 
implemented. multilevel ring structure to control its 
users and to protect itself. The ring structure is a 
generalization of the two-state capability of other 
computer systems (master/slave mode, supervisor/ 
program state, etc.). With Multics, the structure has 
been expanded to eight states or "rings of protec- 
tion" numbered 0 (most privileged) through 7 
(least privileged). The operating system resides in 
the most privileged rings, 0 through 2, while users 
generally operate in the less privileged rings, 3 
through 7. The segments of the operating system 
are in the most privileged rings to prevent uncon- 
trolled access or modification by the users of essen- 
tial system information. 

The basic rule is that users can only reference 
those segments in the same or less privileged 
levels than the ring in which they arc currently 
executing. Access to higher privileged rings is 
only possible through a gate program. (This is 
analogous to master mode entry, supervisor call, 
etc.) The use of eight levels of protection rather 
than two allows user programs to take advantage 
of features for protection normally reserved for 
operating system software. 



' In a 1975 study conducted fur the Air l-orcc, the MITKI- CoriHiru 
tion concluded that Multics is the most secure operating .system 
available. 

' Null access is implied by default; that is, it' a user does mil issue a 
command granting another user access to a segment or dirfclnry, 
that other user cannot access the data in any way. However, luii! 
is useful in selecting a small number of individuals from a project 
to whom it is desirable to deny access. 

S()ccincations may change as design improvements are introduced. 
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MulticsPL/I 



Multics PL/I is a language processor designed for 
commercial, scientific, and system programming 
applications. It was developed on Honeywell equip- 
ment in conjunction with the Massachusetts Insti- 
tute ot Technology. Multics PL/I is the language 
defined by the American National Standards Insti- 
tute's PL/I standardization committee and is sched- 
uled to become a standard. 

The compiled code is extremely efficient. The 
compiler was specifically designed for Multics and 
has been used to compile itself and most Multics 
software. 

ADVANTAGES 

Compilation and execution may be initiated 
through absentee (Multics batch processing) or 
interactive mode. 

Programs written in PL/l ensure permanent com- 
patibility and ease of maintenance. 

Object modules are produced such that no relocat- 
able edit is required. The normal mode of opera- 
tion is to execute with dynamic linking and loading 
so that unreferenced data and unused programs are 
never loaded into main memory. 

Relocatable object permits the binding of sepa- 
rately compiled programs together into one seg- 
ment which has fewer pages than its unbound com- 
ponents. 

A run-time symbol table may be created by the 
compiler and used by the Multics debugger to 
make symbolic references to the program data at 
run time. There is no special checkout compiler 
and therefore no recompilation necessary to debug 
a program. 

An optional optimizer perfonns extensive optimi- 
zation of common expressions, conversions, and 
accessing code throughout a procedure or begin 
block. Register allocation is based on usiige statis- 
tics gathered by the optimizer resulting in intelli- 
gent use of pointer registers by the object code. 

CAPAHILiriliS 

PL/I is a hlock-structured language that allows 
both internal and external names. ITiis feature 



facilitates the development and maintenance of 
modular PL/I programs. All procedures are recur- 
sive and sharable. 

Multics PL/I has a comprehensive set of data for- 
mats. These include eight distinct types ol data: 
arithmetic, string, locator, format, label, entry, file, 
and area data. These formats give PL/I considerable 
descriptive power. 

In addition to fixed-point and floating-point binary 
arithmetic, Multics PL/I provides variable-precision 
true fixed-point and Hoating-point decimal arith- 
metic of up to 59 decimal digits directly supported 
by hardware. Stnicture variables (similar to the 
hierarchical descriptions of COBOL) enable the 
programmer to explicitly define data structua's as 
any aggregate of elementary data formats. 

Dynamic allocation for scalar variables and aggre- 
gates is provided by the automatic, controlled, and 
based storage classes. 

PL/I has powerful bit string and character string 
handling capabilities. Operations and functions are 
performed on either fixed or variable length 
strings. The extended instruction set of the central 
processor is fully utilized to perforin character- and 
bit-string operations, pictuiv editing, as well as 
decimal arithmetic and arithmetic base con- 
versions. 

Arithmetic, string, or pointer variables declared 
with the "unaligned" attribute are packed into the 
minimum number of bits, giving the programmer 
complete control over the packing of structures 
and arrays. 

Through the use of pointer-valued Multics func- 
tions and PL/I based variables, a user can easily 
access any bit in the entire virtual memory. 

Declaration of initialized arrays and data structures 
is permitted. Components can be freely interspersed 
in PL/I programs to aid in program documentation. 

Multics PL/I utilizes the full ASCII character set 
defined in American National Standards Institute 
standard X3.4-I%<S. Hotli uppercase and lowercase 
lellers can he used to form names up to 15h char 
acters long. This offers the user greater naming 
llexibilily. 
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The % include macro provides for the inclusion of 
program text without the use of a preprocessor. 

Complete symbol listings show how each name was 
declared, as well as its attributes, and its address 
allocation. 

The ccmipiler diagnoses over 350 errors, giving 
complete, readable dis^nostics that include the 
eiToneous statement or name. Warning diagnostics 
are given for common mistakes such as an 
undeclared name or iinpUcit conversion of data 
types. 

PL/l programs may call procedures written in other 
langu^es or vice versa provided they observe the 
interface conventions, as is the case with the other 
compileTS in the system. 

Multics PL/1 and FORTRAN compilers have simi- 
lar options, program listings, and error messages, 
and in fact share the same compiler code genera- 
tion module phase and are, therefore, completely 
compatible. 

PL/I input/output facilities provide a convenient 
method of constructing and maintaining large files 
within the virtual memory or on removable media. 

The PL/I "do" statement and "if statement allow 
the programmer to construct flexible program logic 
without the proliferation of statement labeh. 



Tlie "on" statement of PL/1 permits the program- 
mer to make arrangements to handle special condi- 
tions which arise during execution. These condi- 
tions can arise as the result of errors recognized by 
the hardware or be signalled by the program itself. 

Multics virtual memory, coupled with PL/l pointer 
data, facilitates the programming of complex list 
processing techniques. 

OTHER MULTICS FEATURES 

Multics PL/I is a powerful language on a powerful 
system. One of the most advanced computer sys- 
tems in the world, Multics offers extensive security 
provisions, virtual memory, interactive program- 
ming environment, hierarchical storage of data, and 
highly functional administrative control features. 
For more inforniation on the Honeywell Multics 
System, contact your Honeywell Marketing n.*pK- 
sentative. 

SYSTEM CONFIGURATION 

The functions herein described are applicable to 
any Level 68 Multics configuration. 



Specif icatiuns may change as design impruveinents urc introduced. 
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Multics APL is an advanced version of the APL 
programming language an interactive system for 
use with Honey well's large-scale Level 68/DPS 
computers. Multics APL is a general purpose lan- 
guage that is both easy to learn and powerful to 
use. It is interactive by design - problems can be 
attacked swiftly, error messages are informative, 
errors can be corrected quickly and easily - all 
within the APL environment. 

APL brings the full scope of data processing to 
business and technical problem solvers who may 
have little programming experience. 

It is particularly well suited for business and scien- 
tific applications requiring the manipulation of 
arrays of data. Typical business applications include 
financial modeling, investment analysis, sales fore- 
casting, and payroll and budget analysis. Scientific 
applications include linear programming, regression 
analysis, and pipe stress networks. 

BENEFITS 

Multics APL offers substantial benefits: 

• Provides powerful language statements for 
easier problem solving 

• Provides a set of tools for interactive develop- 
ment, debugging, and execution of programs 

• Offers data processing capabihties for any level 
of programming expertise 

• Reduces time for programmer system develop- 
ment thereby increasing programmer productivity 

FEATURES 

The following features make Multics APL partic- 
ularly attractive: 

• File access capabilities 

« Ability to store APL functions and programs 

for later execution 

• Ability to automatically start a function 
executing when program is loaded 

• Powerful execute operator which interprets a 
character string operand and may produce a 
character string result 

• Ability to diagnose errors in a longer, more 
explanatory format to assist new APL users 



• Support of ASCII terminals and a variety of 
APL terminals (especially graphics terminals) 

• Several preprogrammed workspaces, including 
a fully documented, tutorial course for user self- 
instruction in Multics APL 

• ASCII-compatible character set 

• Accurate floating point computations 

• Sizable arrays and unlimited workspace in 
virtual memory 

• File system that does not require knowledge 
of job control language 

• Full security and integrity protect programs 
and data frojn unauthorized use or modiriciition 

• Convenient interface to other Multics pro- 
gramming languages 

• Software to convert from IBM to Multics 
format 

• Ability to access Multics data bases via 
PL/I subroutines 

SYSTEM DESCRIPTION 

System operation is straightforward. At a termi- 
nal, the user simply calls Multics APL, and then 
types an expression to be evaluated. The Multics 
APL interpreter performs the calculations, prints 
the results, and awaits a new input line, riic results 
of an expression evaluation can also be assigned to 
a variable and retained from line to line for use in 
subsequent evaluations. 

In addition, a secjuence of calculations can be 
stored as a function to be recalled by name and inter- 
preted as a single entity. The result of the liinctit)!! 
is processed as though the entire sequence ol' expres- 
sions had just been entered at a terminal. Results 
from any form of expression evaluation may be 
printed at the terminal, presented in graphic form 
(on a suitable terminal), formatted into a tabular 
report, or stored in a file for subsequent retrieval 
and processing by Multics APL, or other program- 
ming languages. The entire state of any Multics APL 
session may be saved for subsetiueni use, incluiiing 
all variable names, their current values, and stored 
program functions. 

The APL language employs a special character set 
(normally requiring a special APL terminal) in 
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which most operations are represented by a single r 
character. Besides the more common operations 
(add, multiply, etc.), Multics APL provides single- 
character operations for more complex functions, 
such as sorting, random number generation, and 
matrix inversion. Some of these functions are 
suited particularly to the manipuiation of large or 
complicated data arrays. 

Access to a special APL terminal is not required; 
Multics APL can be itted from an ASCII terminal 
through a special set of over-strike conventions. 
Unlike similar conventions in any other APL, this 
convention preserves the visual appearance of APL 
programs. It is as easy to read Multics APL pro- 
grams on an ASCII terminal as it is on an APL 
terminal. Multics APL supports all APL terminals - 
including EBCDIC, Correspondence, APL/ ASCII 
bit-paired, and APL/ ASCII typewriter-paired. 
The Multics APL character set is a compatible 
superset of ASCII; hence, character data can be 
easily and efficiently shared between APL and 
other Multics programming languages. 

By using powerful APL language elements, the 
user can devote full attention to solving the prob- 
lem at hand. Multics APL helps the user avoid the 
complexities of the individual programming steps 



required and the interrelationships of the system 
operation. For example, inversion of a matrix, 
which would involve many program statements 
with nested too{» and indexing in other pro- 
gramming languages, is accomplished with a 
singlencharacter operation in Multics APL. 

Multics APL can call APL functions written in 
PL/I, which, in turn, can call programs written 
in BASIC, COBOL, or FORTRAN. The PL/I 
coded function can be niladic, monadic, or 
dyadic, and can optionally return a result. It can 
diagnose the same errors any APL operator can 
diagnose and can call out to any other Multics 
subroutine or system interface. 

thus, this facility enables the APL user to get at 
any system interface or application program by 
writing a short PL/I program to transform the call. 
This means the Multics APL user can easily inter- 
face to the Multics Graphics System, the Multics 
Relational Data Base Manager, and other packages. 

SYSTEM REQUIREMENTS 

Multics APL runs under the control of the Multics 
Operating System on all models of Level 68/I)PS. 

SpcciHcations may chanttc u.s dexi{;n imprnveinenis arc iiilrtttliiml. 
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Honeywell's Multics Data Base Manager (MDBM) 
provides Level 68/DPS users with a powerful, 
versatile, efficient, and easy-to-use data base man- 
agement capability. MDBM functions as a subsystem 
of the Multics operating software, and makes use of 
the Level 68/DPS virtual memory and file manage- 
ment subsystems. It is designed to support concur- 
rent access to up to 64 data bases of up to 1 80 
billion characters each. 

Much of the versatiHty of MDBM derives from the 
fact that it offers the user a choice of two different 
methods for structuring and manipulating a given 
data base: a relational approach and a procedural, 
CODASYL-standard (Conference on Data System 
Languages) approach. While all data is stored in a 
relational format, two differing interfaces are 
visible to the user. 

The relational technique greatly simplifies the job 
of programmers and end-users, as a detailed knowl- 
edge of the logical structure of the data base is not 
required to use it. MDBM performs the retrieval 
function automatically. For example, a person 
seeking data writes a statement that defines the 
nature of the data required; lie does not provide 
specific instructions as to where and how the data 
is to be retrieved. 

At the same time, the procedural approach is 
available to those programmers who are familiar 
with and prefer CODASYL data base techniques. 

MDBM is the industry's first fully implemented 
relational data base manager commercially available 
from a computer manufacturer. It is also the only 
data base manager to offer both relational and 
CODASYL capabilities in the same system. 

MDBM BENEFITS 

The Multics Data Base Manager provides the follow- 
ing bene 11 Is: 

• Impro vi'd proftrammvr prodm fivif) • Program- 
nicrs cun accomplish data base tasks with much 
less effort when employing MDBM's relational 
capabilities. 

• New cnd-uscr flcxibiUiy Because of the sim- 
plicity of relational techniques, end-users can inde- 



Multics 
Data Base Manager 

pendently retrieve data base information without 
support from the programming staff. 

• Ease of maintenance — The tasks of entering and 
changing data are greatly simphfied. 

• Data storage efficiency One data base system 
can meet the needs of an entire organization without 
redundant files and effort. 

• Improved data accuracy The elimination of 
redundancy ensures consistent information with 
fewer chances of error. 

• Ensures data integrity and security - Inherent 
Level 68/DPS integrity/security features are avail- 
able to the MDBM user. 

MDBM FEATURES 

The Multics Data Base Manager includes the follow- 
ing significant system design features: 

Relational interface - Multics Relational Data Store 
(MRDS), a component of the data base manager, 
represents data relationships by means of formal 
algebraic entities. A user structures and accesses 
data files without concern for how ov where (he 
data is actually stored. As a result, the user's task 
is greatly simplified. 

Procedural interface - Multics Integrated Data 
Store (MIDS) provides an interface with the data 
base manager following CODASYL standards. 
MIDS is a subset of Honeywell's l-D-S/II data base 
management system. This capability is highly llex- 
ible, allowing the building of network, hierarchical, 
sequential, or cyclical structures. 

Language independence - Any Level 68/DPS 
supported language may be used to access MDBM 
facilities, including COBOL-74, PL/1, FORTRAN, 
APL, BASIC, and Assembler. Well-defined CALL 
statements arc employed. 

Independence ttf processing modes MDBM sup- 
ports all processing modes .such as Iransaclion proc- 
essing, time sharing, batch, rernote job enlry and 
direct access. All of these modes can be supporled 
sinuillaneously. 

Conf rolled sharing All user dala (as well as opei- 
ating system .software, libraries, and u.ser code) is 
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potentially snareaDie at the discretion of its owner. 
Since all Level 68/DPS language processors generate 
only pure reentrant code, no copies or reloads are 
required. 

Data definition and program independence - Data 
definition is an independent function. In most cases, 
changes to the data base will not require repro- 
gramming of user applications. 
Query capability - A special MDBM query language, 
termed LINUS (Logical INquiry and Update System), 
provides comprehensive query capabilities. 
Online access and update — Records may be easily 
added, modified, or deleted online. Multiple users 
may access the same data base concurrently. MDBM 
can be invoked by as many users as are allowed on 
the system. 

Concurrent access and update controls - Update 
privileges can be assigned to individual users or 
classes of users. To ensure integrity, users may 
specify exclusive use of the data base when it is 
opened; or, if sharing a data base, users may tem- 
porarily reserve a record type and associated sets 
during critical update operations. It is possible for 
privileged users to specify exclusive update, which 
locks out all other processes attempting to access 
the data base; and it is also possible to specify ex- 
clusive retrieval, which locks out all updaters from 
the data base. 

Report generation - The Level 68/DPS Report 
Generation Language (RGL) facilitates the produc- 
tion of reports, in conjunction with either the 
LINUS query language or ASCII files. 
Automatic data recovery and restart - MDBM uses 
Level 68/DPS backup/retrieval mechanisms. They 
provide recovery of a data base after system failure 
or when a disk has been damaged. 
Monitoring — Tools exist to monitor data base usage 
from various aspects. 

Dynamic tuning - A system administrator can view 
current monitoring data from a terminal and dynam- 
ically alter parameters to affect performance. 
Data integrity and security - Level 68/DPS is the 
only system where all data integrity/security fea- 
tures are implemented in both software and hard- 
ware. MDBM derives its superior integrity /security 
characteristics not from provisions within the data 
base manager, but rather from design features of 
the Multics operating system and Level 68/DPS 
hardware. 

TERMS DEFINED 

The rclatioiuii and CODASYL approaciies have 
developed separately, so that terms used in de- 
scribing one npproach differ substantially from 
those used for the other. Table 1 is provided to 
bridge this terminology gap. 



TABLE! - TERMS 



Traditional 

rintn PnwfKKirK^ 

Terminology 


Honeywell MDBM 


Relational 
rtppniacn 


CODASYL 


Record type, class or 
format (physical) 


physical record 


physical record 


Record type, class or 
format (logical) 


relation 


record typo 


Record occurrence 


tuple 


record occurrence 


Field/element 


attribute 


data clcmenl/ricld 


Range of values (the 
set of all values associ- 
ated with a field type) 


domain 


largely ignored 


Total data base defi- 
nition 


data model 


schema 


Program view of data 
base 


data submodel 


subschema 



DATA BASE DEFINITION PROCESS 

Figure 1 illustrates the MDBM data base definition 
process. Users may create and access a data base 
using either the MRDS or MIDS interfaces with the 
following restrictions: 

• A data base created using the MIDS facility may 
be accessed only with MIDS programs. 

• A data base created using the MRDS fiicility may 
be accessed only with MRDS programs. 

The definition of a data base in MDBM is accom- 
plished by the user or data base administrator de- 
tlning either: 

• A data model for a relational data base. 

• A schema for a CODASYL data base. 

The data descriptions are not directly referenced 
by user application programs, and each application 
program may have a different view of the data base. 
The definition of that portion of the total data base 
affecting a particular program is accomplished by 
defining either: 

• A data submodel. 

• A subschema. 

Partial views (data submodels or subschemas) nuist 
be proper subsets of the total data base dolinilion. 

In the case of a relational (MKI)S)data base, I he 
data model definition lile contains the complete 
description of the different data elements to he 
found in the data ba.se. This is the data base aduiin- 
istrator's view of the data base. The data subnunlel 
definition file contains the definitions of those re- 
lations and attributes of interest to a specific pro- 
gram. This is the user's or programmer's view of (he 
data base. The data submodel is defined indepeiul- 
ently of the data model and no binding is done 
until application program execution open-time. 
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Data types for data submodel attributes are not 
defined within the data submodel; they are defined 
within the application program. They may differ 
from the data types defined in the data model for 
the corresponding attribute name. Allowable data 
types (in PL/I terms) are real and complex fixed 
binary, real and complex floating binary, real and 
complex decimal, varying and nonvarying bit string, 
and varying and nonvarying character strings. 
Binary data types may be single or double precision. 

When a data base administrator defines an MIDS 
data base, both a schema and a data model defini- 
tion file are automatically created (Figure 1). The 
schema definition file contains only information 
associated with a CODAS YL data base relevant to 
the data structure/organization of that di^ta base. 
Schema entries contain data and network structure 
information while data model entries contain de- 
scriptions of the data elements in the data base. 

Again, data descriptions in the schema definition 
file are not directly referenced by user application 
programs. The user or data base administrator de- 
fines that portion of a total data base of interest 
to a particular program by use of a subschema. A 
subschema definition contains only the application 
program view of the data base and is the MIDS 
counterpart of the data submodel in MRDS Gust 
as the schema is the MIDS counterpart of the data 
model). 

In practice, MIDS controls structural definitions, 
whereas MRDS controls data definitions. 



THE RELATIONAL DATA STORE 

The Multics Relational Data Store (MRDS) pro- 
vides an integrated set of functions to support the 
description and processing of a wide variety of data 
base structures. Data independence is achieved 
through the use of data model/submodel concepts. 

The MRDS user detines a data model using a tech- 
nique known as "normalization" or "reduction 
to third normal form." The process of normalizing 
a data base consists of a subjective process per- 
formed by the data base administrator whereby 
complex relations are reduced or transformed into 
simpler relations without loss of information or 
dependencies. The rationale for using the third 
normal form relational model derives from certain 
anomahes which can otherwise occur in a relational 
data base. 

The data model or data base definition is defined, 
accessed, and maintained by the data base admin- 
istrator. The administrator, working in conjunction 
with application users, defines a valid data sub- 
model to be referenced by each application pro- 
gram. Under certain user-controlled circumstances, 
a user may act as his/her own administrator and 
deal directly with the data model. The data sub- 
model provides each application program with its 
view of a data base and must be a proper subset of 
the data model. 

The definition of a data submodel may differ from 
the data model in several ways: 

• Attribute names may differ. 

• Attributes may be omitted from a data model 
relation. 

• Attributes may be ordered differently within a 
relation. 

• Relations may be omitted. 

A data submodel definition may be created sepa- 
rately or in conjunction with an application program. 
Several data submodels may be associated with the 
same data model. Several data submodels may be 
referenced by the same application program. Data 
submodel definitions may intersect. 

When defining a relation in a data model or sub- 
model, it is nece.s.sary to specify which allrihules or 
fields are to be used as components of the primary 
key (i.e., key atthbules). l-ach lupJe or record 
occurrence must be identiliable by some non-null 
primary key value which must be uni(iue. The ex- 
pression for defining a relation and its allrihules 
resembles the format used in most relational 
literature. 

The "open" procedure is called when (he MRDS user 
wishes to access the data base. At (his time the dala 
model and submodel are resolved. I'igure 2 illus- 
trates access activity. 
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Figure 1. MDBM Data Base Definition 
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Figure 2. MDBM Data Base Access 



The MRDS Languagt: Processor provides the user 
with the following capabilities: 

• Open and close a data base defined by a specified 
data submodel. 

• Retrieve data based on a flexible selection capa- 
bility. 

• Modify and delete items within a data base. 

• Enter new information into the data base. 

• Perform the above while allowing for the maxi- 
mum possible concurrent access capability. 

The data manipulation capability provided is rela- 
tionally complete. That is, it possesses the full 
power of the relational calculus. Any query expres- 
sible in first-order predicate calculus is expressible 
in an MRDS selection mechanism. 

THE MULTICS INTEGRATED DATA STORE 

The Multics Integrated Data Store (MIDS) provides 
a CODASYL language interface to the functions re- 
quired to support the description and access to 
CODASYL data base organizations, including hier- 
nrcliios and networks. Data indc|x.'ndencc between 
the physieal data base and applieation pn^grams is 
achieved llirough use of schema and subschema con- 
cepis as specified by CODASYL. 

riie schema describes tlie total data base and is 
defined and maintained by the data base adminis- 
trator. The administrator, working with prospective 
users, defines valid subschemas to be referenced by 
individuiil application programs. 



The subschema must be a proper subset of the 
schema. The subschema contains only the infor- 
mation necessary to define the data required by the 
application program. 

MIDS relies primarily on access control lists rather 
than privacy locks or passwords to provide security 
at the level of the record and set. Concurrent update 
protection is provided at the record type and set 
name level. 

The following specific CODASYL schema defini- 
tion functions are supported by MIDS: 

• A data base, records, fields, and sets may be given 
names. 

• Record location mode may be specified as CALC 
or VIA SET. (All records in MIDS must be given u 
unique control key field even if the location mode 
is VIA SET.) 

• Field types may be BINARY, DECIMAL 
SIGNED, or CHARACTER. 

• Sets may be defined. 

• ORDER of set insertion is defined as PERM A- 
Nl'NT INSERTION and DUPLICATES NOT 
ALLOWED for SORTED ORDl-R. 

• Set members may be ordered ;>s I'lRS l", NI X T. 
LAST, PRIOR, or SORTIE) BY DlU-lNl D Kl YS. 

• Set membership is ilellncd as MANDA r()R>' aiui 
AUTOMATIC. 

• Set selection may be THRU OWNER IDEN l l- 
FIED BY CALC-KEY or BY APPLICATION. 
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A subschema may describe only that portion of the 
entire data base (i.e., schema) which is of particular 
interest to the application program. (A schema may 
be shared by a number of subschemas.) A subschema 
may differ from the schema in the following ways: 

• Field names may be renamed or omitted from a 
subschema record. 

• Field names may be ordered differently within 
records. 

• Field types may differ from the corresponding 
schema Held type (although field types are not de- 
fined in the subschema, per se). 

• Records may be renamed or omitted. 

• Sets may be renamed or omitted. 

Several subschemas may be referenced by an appli- 
cation program and subschema definitions may 
intersect. Subschema record, field, and set names 
must be associated expHcitly with schema record, 
field, and set names. Field types are defined in the 
using application program. 



At execution time the validity of the subschema is 
verified and the views of the data base represented 
by the schema and subschema are resolved. 

The following basic functionality is provided by 
MIDS Data Manipulation Language (DML): 

• READY 

• STORE 

• ERASE 

• FIND 

• GET 

• MODIFY 

• FINISH 

• KEEPX 

• FREEX 

It is possible to READY multiple subschemas within 
one process. 



Specifications may change as design improvements are introduced. 
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LINUS (Logical Inquiry and Update System) is a 
powerful and easy-to-use facility for accessing 
data bases from a remote terminal. It provides 
complete data base management capabilities, 
including both retrieval and update operations. 
LINUS functions as a subsystem of the Multics 
operating software and uses Multics Relational 
Data Store (MRDS) for data base access. LINUS 
is used by a variety of business professionals, 
including inventory control personnel, budget 
planners, geologists, and school administrators. 

LINUS uses a high level, nonprocedural data 
selection language called LILA (Linus LAnguage). 
LI LA allows people, who are not trained program- 
mers, to solve problems by working with data bases. 
The user views the data base as a simple set of 
tables, consisting of rows and columns; LILA 
provides an easy way to "look up" information 
contained in those tables. 

System operation is straightforward. At a terminal, 
the user simply calls LINUS and types a request 
for LINUS to open the desired data base. If the 
user is unsure of how to proceed, he types "help" 
for assistance. After the data base is opened, the 
user may call LILA and type a selection expression 
specifying the data to be accessed. LILA then proc- 
esses the selection expression, retaining it in a form 
suitable for reference by subsequent LINUS 
requests. 

After selecting the data, the user may type a LINUS 
request to manipulate it. Among the actions which 
can be performed are display the data on a terminal, 
write a formatted report, place the data into a 
Multics file for later use, and update the data base. 
The data may be acted upon by several manipulation 
requests, and new data may be specified at any time 
by typing a new LILA selection expression. 

BENEFITS 

LINUS is easy to use. With three short words even 
an inexperienced computer user can get information 
from a data base using LINUS. These words arc 
"select," "from" and "where." l-or example, a 
telephone directory can be thought of as being a 
table with three columns of information: name, 



address, and phone number. To find the phone 
number of John Smith, the user scans the name 
column for "Smith John" and reads the value from 
the phone number column in the same row. With 
LINUS, using LILA, this operation is described as: 

select number 

from phone book 

where name = "Smith John" 

Studies and experience have shown that inex- 
perienced users can attain substantial competence 
in LINUS within a matter of hours. 

Other benefits include: 

• Direct End-User Access - Using LINUS, the 
user can independently retrieve and update data 
base information without support from the 
programming staff. 

• Support of Unforeseen Recfuirements The 
LINUS user can immediately respond to unexpected 
information requirements by interactively selecting 
the desired data via a terminal, without writing a 
program. 

• Complete Selection Capability LINUS is 
powerful and "complete" in the sense that the user 
can select any information contained within the 
data base using LILA, subject to security constraints. 

FEATURES 

• Complete Data Base Functionality LINUS 
provides facilities enabling the user to add and 
delete rows from a data base table, to modify 
column values in a table, to define temporary tables 
for personal use, and to retrieve information from 
one or more specified tables. 

• Macro Facility A parameterized macro facility 
allows the user to invoke previously saved sequences 
of LINUS requests. This allows the tailoring of an 
environment to an individual user. 

• LILA Line Editor A BASIC-like line editor 
built into LILA simplifies construction of data 
selection expressions. 

• liuilt-in and User-defined /''unctions Hnill in 
functions allow the user to determine sums, averages, 
and counts, of data as well as to search on such 
items as partial character string values, and roundeil 
or truncated numeric values. In addition, there is 
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a welJ defined method for dynamically adding 
functions required by local users. 

• Internal Variables - The LINUS user can assign 
retrieved data values to internal variables, allowing 
subsequent data selections to be dependent upon 
previously retrieved data. 

• Help Facility - A help request available within 
LINUS provides information on how to use its many 
facilities. The user need only type "linus" to invoke 
the subsystem, and "help" in order to begin using 
LINUS. 

• Table of Contents - The contents (tables and 
columns) of the data base may be displayed 
allowing a person unfamiliar with the structure and 
content of the data base to use LINUS. 

• Report Writing Capability - Formatted reports 
from retrieved data can be created using either 
the Mullics Report Program Generator (MRPG) 
or the WORDPRO facility, Lister. Either facility 
can be invoked with a simple LINUS request. 

• Multics - Any Multics capability can be invoked 



from within the LINUS subsystem. Some possible 
uses of this feature are sorting retrieved data viii 
the Multics sort facility, or editing retrieved data 
with one of the Multics text editors. 

• Data Base Creation The user can create w 
private data base via easy-to-use MRDS commands. 
Special documentation oriented to the LINUS user 
makes this process especially simple. The data Ixise 
can then be maintained and accessed using LINUS. 

• Data Sharing, Integrity, and Security - LINUS 
fully utilises MRDS and Multics facilities for con- 
current usage control, data base security, and data 
base backup and recovery, 

SYSTEM REQUIREMENTS 

LINUS operates under Multics on any Series 60, 
Level 68/DPS configuration, 1 he availability of 
MRDS is a prerequisite for LINUS operation. 



Specifications nuiy cliungc us design improvements ;ire inlrtuliu'ed. 
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WORDPRO, another dimension of Honeywell's 
powerful Level 68/Distributed Processing System - 
Multics - provides a comprehensive set of software 
tools for developing a wide range of documents 
online. And because WORDPRO is integrated 
within the Multics operating software, its users can 
develop and maintain documents ranging from sim- 
ple form letters to complex technical presentations 
simultaneously with other data processing activities. 
The end result can be rapid turnaround time, im- 
proved productivity, and optimal quaUty in docu- 
ment preparation. 

WORDPRO BENEFITS 

Since WORDPRO is an integral part of Level 68/ 
DPS, it offers advantages unavailable with other less 
comprehensive word processing systems: 

• Ease of Use — People with little or no knowledge 
of Level 68/DPS or word processing can easily use 
WORDPRO for numerous text processing tasks. 
Merely by following WORDPRO-generated instruc- 
tions, even inexperienced users can readily perform 
functions such as text entry and simple editing. 

• Security - The security provided by WORDPRO 
is the same security provided for all information 
stored in the Multics virtual memory. Because 
WORDPRO-prepared documents reside in the vir- 
tual memory, they receive the same high degree of 
security afforded any other job, file, or program. 

• Document Management Tools - WORDPRO docu- 
ment management tools make it easy to maintain 
documents online or offline in a standard format. 
These tools can be used for document file manipu- 
lation, archiving, document linkage, etc. The same 
tools which control 68/DPS storage also control 
WORDPRO documentation. 

• Tailored Environments - Level 68/DPS lets the 
WORDPRO user define exactly how text process- 
ing is to occur. Unlike other systems, WORDPRO 
users specify the types of terminals to be used 
;ind llie various document formats to bo accepted. 
Interfaces to these devices can be changed at any 
time. 

• Selectable Administration The WORDPRO 
user is not bound by a restrictive administrative 
approach. Each site can define what the individuals 



using the system (terminal operators and document 
administrators) need to know. The roles of these 
individuals can be large or small depending on how 
a user's document processing activities are estab- 
lished. 

• Maximum Equipment Utilization - WORDPRO 
can help users make maximum use of slack com- 
puter time. Rather than have the system sit idle 
when not processing data, WORDPRO can use 
this extra time efficiently for text processing 
thus maximizing equipment utilization. 

• Total Integration with Data Processing - Within 
Level 68/DPS, word processing and data processing 
are fully integrated. Data and text files created and 
maintained by WORDPRO can be accessed and 
used by data processing applications. Conversely, 
files created and maintained by data processing 
applications are available to WORDPRO users, all 
without special programming or conversions. 

DEVICE FLEXIBILITY 

Any terminal accepted by Level 68/DPS can be 
used for word processing. Users need not purchase 
special equipment or dedicate terminals for 
WORDPRO applications. If one set of tcrniitiuls 
is used for input and update, other devices can be 
used for output. Text entered from one terminal 
can be modified by another without regard to 
terminal characteristics. 

TEXT ENTRY TOOLS 

Several tools are provided with WORDPRO for 
the entry of new text. With these tools, an indi- 
vidual with little or no prior word processing 
experience can easily power type raw text into 
the system for later update or incorporation into 
a document. 

The DOCUMENT routine is a simplified interface 
to all the WORDPRO tools. It lets the user pre- 
define document formats, and automatically 
generates the final document with paragraph and 
page numbers, footnotes, tabic of contents 
(optional), etc. Paragraph editing is provided to 
allow paragraph addition, modification, and de- 
letion with automatic renumbering. Whole para- 
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graphs may be inserted from a prepared list of 
paragraphs. Speed typing, hyphenation, and all of 
the quality control and document management 
tools are also provided within the DOCUMENT 
interface. Once processed through DOCUMENT, 
the text can be printed at a terminal or high- 
speed printer. 

SFEEDTYPK - similar to typing shorthand - 
allows users to specify abbreviations for input of 
character sequences. When a document is printed, 
these abbreviations are automatically expanded 
to their predefined strings. The result is fewer 
key strokes typed, higher document quality, and 
reduced storage requirements. 

TEXT EDITING 

Input text can be modified using either of the 
WORDPRO editors: cursor or string. Using a CRT 
device and the cursor editor, terminal users can 
simply type over portions of a document which 
are to be changed. 

String editing, which is more comprehensive than 
cursor, enables the user to manipulate strings of 
characters in a text for editing or updating pur- 
noses. String editing functions range from simple, 
line-oriented editing to context-oriented searching 
and replacement. 

Together, the WORDPRO cursor and string editors 
give the user the freedom to select the desired 
mix of simplicity and comprehensiveness. 

DOCUMENT FORMATTING AND HYPHENATION 

Tlie WORDPRO formatter provides document for- 
mat control. In addition to margin and page length 
control, the formatter handles automatic page and 
paragraph numbering, widow processing, table of 
contents and index generation, font and forms 
control, artwork placements, and automatic hy- 
phenation. Further, the formatter can control: 

• Headers/ Footers - Up to 20 headers and footers 
can be specified. These can be page numbers, copy- 
rights, logos, or the current date. These need only 
be specified once; they will be inserted automat- 
ically thereafter. 

• Footnotes - They are automatically generated, 
numbered, inserted, and maintained with the 
proper page. If footnotes are added or deleted, 
the remaining ones are automatically renumbered. 

• Pagination Pages can be automatically num- 
bered in Arabic or Roman numerals, in upper- or 
lowercase, or alphabetically. 



QUALITY CONTROL 

WORDPRO incorporates an extensive set of qual- 
ity control tools for detecting and removing typo- 
graphical errors from docuilients. First, SPFED- 
TYPE can be used to correct typos at entry time. 
For example, common typing errors such as 'Mite" 
instead of "the" can be corrected by predefining 
the former string as an abbreviation to be ex- 
panded to the latter. Or, long difficult-to-spell 
words can be abbreviated, thus eliminating fre- 
quent misspellings. 

Online dictionaries can also be used to detect 
misspelled words within a document. WORDPRO 
offers a dictionary containing over 50,000 cor- 
rectly spelled English words. The content of a doc- 
ui^ient is compared with the dictionary's entries, 
and any words not found are entered in an error 
file or printed at the user's terminal. Multiple 
dictionaries can also be developed. For example, 
a dictionary of technical jargon or frequently used 
non-English words could be established so that 
these types of words would not be considered 
misspelled. Dictionaries can be shared, if desired, 
or used as private versions. Dictionaries can also be 
added to or deleted from as desired. 

Change bars can be generated on documents under- 
going review. A complete list of changes (line-by- 
line) can also be generated in a separate Tile ol 
notes. Additionally, text comparison programs 
allow review of new documents against older 
versions. 

LIST PROCESSING 

The generation of personalized form letters and 
billing statements can be accomplished using 
WORDPRO'S list processing capabilities. Lists of 
mailing addresses can be used concurrently by 
multiple terminal operators to create tiiese types 
of documents with key pieces of information in- 
serted at various points. These list processing tools 
can also be used in conjunction with other 68/DPS 
facilities (such as the data base manager) to supply 
current up-to-date account information for nu>nthiy 
statements, billings, etc. Mailing labels or pre- 
addressed envelopes can also be generated. 

ARTWORK 

WORDPRO can be used to generate diagrams, 
organization and How charts, and logos. These 
figures can be included as pari of (he final, prinlcd 
copy of a document. 
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OUTPUT CONTROL 

Numerous devices can be used to print review cop- 
ies or final documents. A terminal operator may 
request that a segment of text be output on a 
local or remote printer, thereby freeing the input 
terminal for other work. Line printers, plotting 
terminals, and CRT devices can all be used for 
output. 

High-speed offline printers, such as the Honey- 
well Page Printing System, can be used in con- 
junction with WORDPRO to generate multiple 
copies in multiple colors with preprinted forms. 
Special forms control capabilities for line printers 
and plotting terminals permit documents to be 
printed on multipart, tear-away, or peel-off forms. 

Computer output microfilm/microfiche interfaces 
are available for generating, distributing, or archiv- 
ing documents on micro media. Documents can 
also be stored in files online, or maintained off- 
line on tape, cards, etc. 

PHOTOCOMPOSITION 

Tlie WORDPRO design incorporates a photocom- 
position interface to allow the generation of con- 
trol information for automatic typesetting devices. 
This photocomposition facility is table-driven so 
that a variety of devices can be easily supported 
by simply modifying control tables. 

ELECTRONIC MAIL 

WORDPRO provides its users with a compre- 
hensive, secure electronic mail facility. This 



faciUty allows message-switching networks to be 
established. Users can send and receive mail rang- 
ing from short, immediate messages to lengthy 
memos or documents, over these networks. Secur- 
ity is provided via a personal or shared mailbox 
area which is subject to extensive access control 
checking. Electronic mail can be the basis for the 
automation of a business's entire in-house mail 
operation, eliminating the need for couriers. 

ACCESSIBILITY OF OTHER FACILITIES 

Because WORDPRO is an integrated part of 
Level 68/DPS, its users can access other facil- 
ities. For example, financial data stored in a 
68/DPS data base can be selectively inserted into 
a WORDPRO-generated document to produce an 
up-to-date monthly or quarterly statement. Tlie 
68/DPS Interactive Graphics package can be used 
to generate artwork for WORDPRO documents, 
and the Multics file management and manipula- 
tion tools can be used with online WORDPRO 
files. 

ADMINISTRATIVE TOOLS 

Implemented on a project-oriented basis, 
WORDPRO can easily control the use of proc- 
essing resources, access to documents and tools, 
billing for usage, etc. Users can be restricted to 
certain functions, or allowed access to full capa- 
bilities of WORDPRO. All the administrative 
controls provided by Level 68/DPS are applicable 
to WORDPRO administration. 

Specifications may change as design improvements are introduced. 
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Multics Graphics 

System 



The Multics Graphics System provides a general 
purpose interface through which user or applica- 
tion programs can create, edit, store, display, and 
animate graphic material. 

FEATURES 

• High degree of terminal independence 

• Ability to define graphic objects that may be 
used repeatedly in higher-level objects 

• Powerful editing facilities for graphic objects 

• Ability to store graphic objects permanently 

TERMINAL INDEPENDENCE 

The Multics Graphics System is organized into two 
distinct parts: the terminal-independent portion 
and the terminal interfaces. 

User and applications programs communicate 
exclusively with the terminal-independent portion 
of the system. This ensures that: 

• User programs and applications routines are not 
restricted to one particular terminal type, but can 
use whatever graphic terminal is available. 

• Users are not isolated from each other because 
of the types of terminals they use, but may freely 
use each others' programs on their own terminals. 

• (Graphic applications may easily be transferred as 
new and improved terminals become available. 

The Multics Graphics System can accept new types 
of graphic terminals with a minimum of coding. In 
most cases, the user need only specify the special 
characteristics of his terminal in a table and con- 
struct a program to perform any code conversion 
necessary. No special I/O programming is required. 
He may then use any existing program or graphic 
file and obtain comparable results on his own 
device. 

STRUCTURED GRAPHIC OBJECTS 

Kather than treat graphic data as an unstructured 
collection of graphic elements (much as a sketch 
could be considered an unstructured collection of 
lines and points), the Multics (ilraphics System 
deals with structured descriptions of objects. 




Sample Graphic Displays 




1 his organization has three advantages: 

• Natural representation of most objects can be 
made in terms of their own inherent organization. 
For example, a piston, a complex object in its own 
right, may be treated as an elemental object within 
a graphic description of an engine. 

• Subpictures can be shared, thereby eliminating 
redundancy. 

• Powerful global picture editing capabilities are 
possible. 

PERMANENT GRAPHIC STORAGE 

Facilities are provided so that the user can attach a 
name to any graphic object and store it in a Multics 
segment. Such objects may be used at any time by 
any user authorized to access the segment. 

TERMINAL-INDEPENDENT GRAPHIC 
TRANSMISSION 

Graphic information is transmitted in a well- 
defined terminal-independent code. This code may 
be interpreted by a Multics program and converted 
to the appropriate codes to drive a graphic 
terminal; or it may be transmitted directly to an 
intelligent graphic device that performs its own 
interpretation, with a corresponding increase in 
efficiency. It may also be directed to a Multics file 
and "played back" on any graphic device to form 
background scenes or standard "canned" pictures. 



Graphic input sent to a Multics system is converted 
from its original format into this code before being 
forwarded to the terminal-independent portion of 
the system. 

SYSTEM COMPATIBILITY 

Programs originally written on other computers 
that make use of the most widely used set of 
graphic subroutines may, with minimal conversion, 
interface in the same way with the Multics 
Graphics with System. Interfaces to mimic other 
popular graphics systems are easily constructed. 

DYNAMIC AND INTERACTIVE GRAPHICS 

When used with a terminal of sufficient intel- 
ligence, the Multics Graphics System can perform 
real-time graphic operations, such as dynamic 
animation, incremental picture update, local pic- 
ture editing under control of the terminal, and 
sophisticated graphic input. 

SYSTEM REQUIREMENTS 

The Multics Graphics System is applicable to any 
Level 68 Multics configuration. 



Specifications may change as design improvements are introduced. 
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SERIES 60 (LEVEL 68/DPS) 



Multics Elearonic 
Mail Facility 



llie Level 68/DPS (Multics) electronic mail facility 
of fers its users direct, online, person-to-person 
liislribution of text. It handles mail ranging from 
brief memos to multivolume documents and deliv- 
ers that mail immediately to data terminals or on- 
line mailboxes. It is one of the many productive 
personal computing features of the Level 68/DPS. 

Honeywell's electronic mail facility operates in 
conjunction with WORDPRO, the Level 68/DPS 
word processing system, and automates the crea- 
tion, distribution, and updating of text information. 
HIectronic mail can significantly reduce the volume 
of paperwork generated in a typical large organiza- 
tion, dramatically reduce the cost of disseminating 
documents, and avoid the delays normally associ- 
ated with physically generating and transporting 
documents. 

Tlie Level 68/DPS electronic mail facility offers 
definite advantages: 

• Each user can create a private "mailbox" — 
a special storage segment for mail delivery, or 
mailboxes may be shared for group use. 

• Any terminal recognized by the Level 68/DPS 
can send or receive electronic mail - no special 
devices are required. 

• A user can access his mailbox from any Level 68/ 
DPS recognized terminal at any location. 

lilectronic mail provides such distinctive functions 
as: 

• Immediate or deferred delivery of messages, text, 

and other mail 

• Broadcast delivery to groups of users 

• Selective delivery only to persons with a "need 
to know" 

• A secure mailbox facility, protected by tlie full 
range of stringent security controls in Multics sys- 
tem software and hardware, to guard mail from 

unauthorized access 

• Simple commands to prescribe the mailbox 
access and mail functions allowed for specified 

users 

• Many document management tools for text 
manipulation and storage 



VARIETY OF USES 

Tlie Level 68/DPS electronic mail facility luis a 
myriad of business uses. For instance, a hirgc 
organization typically functions from a number 
of widely separated locations corporate head- 
quarters, research and engineering facilities, manu- 
facturing plants, sales and service branches, aiul 
test facilities. Because of these widely separated 
facilities, the slow delivery of vital documents by 
conventional mail often results in communication 
problems. Also, the cost of document reproduction 
and delivery can be considerable. I lectronic mail 
can help solve these communication problems in 
the following ways. 

• After creation, editing, and formatting via 
WORDPRO, text is distributed instantly to recip- 
ients at many locations, thereby reducing distribu- 
tion delays and costs. 

• Online, two-way messages can be exchanged 
between Level 68/DPS users. 

• Mail can be delivered for immediate display at a 
recipient's terminal or stored in his mailbox, when 
the recipient's terminal is occupied with an urgent 
task or not logged onto the system. 

• Automatic acknowledgment-of-mail receipt can 
be requested by the sender. 

• A single, online copy of a large document can 
be maintained for remote perusal, avoiding the 
problems of reproducing and distributing printed 
copies. 

In addition, management of messages and docu- 
ments is aided through a variety of tools in Multics. 
Indexed, ordered archives of past messages can be 
created, searched, updated, appended, or deleted as 
desired. Tlie archives can be searched for key sen- 
tences or phrases, extra copies can be printed, and 
old messages and mail can be periodically and auto- 
matically deleted when no longer needed. 

Text can be examined and updated f rom several 
locations at once, l or example, diirin;' a roiilrav I 
negotiation, a master copy ol the contract can In- 
maintained online via WORDPRO. All inlcrcslcd 
parties the customer, along with market mg. cngi 
neering, legal, finance, etc. can simullane<nisly 
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review and comment via electronic mail without 
the delays involved in the conventional mailing of 
contract review copies. 

SECURE MAILBOX 

The Level 68/DPS electronic mail facility utilizes a 
secure online mailbox approach. Each user can have 
a private mailbox under his home directory, or a 
group of users can share a common mailbox to 
receive mail. Tlie contents of each user's mailbox 
and archive is protected by the extensive security 
controls of the Multics virtual memory and file 
management functions. When mail arrives in a user's 
mailbox, the recipient is immediately notified, if 
his terminal is online to the Level 68/DPS system. 
Tlie user can then selectively display the mail with 
simple commands, save it in mail archive files, or 
delete it. 

TYPES OF ACCESS 

Any combination of six different types of mailbox 
access can be prescribed for a single user or a group 

of users: 

• add - allows the addition of new messages to a 
mailbox. All users are usually given add permission 
so they can send mail. 

• delete - allows the deletion of any message in a 
mailbox; usually retained for use only by the mail- 
box owner. 

• read -- allows the user to select and read any mes- 
sages in a mailbox; usually retained for use only by 
the mailbox owner. 

• ow'fi - allows the sender to read, modify, or delete 
messages he originally sent to a mailbox, but doesn't 
allow access to other messages in the mailbox. 

• status - allows a mailbox owner to check on the 
number of his messages, their sender, length, date, 
etc., in his mailbox, without actually reading them. 

• wakeup - allows a message to be sent to a mail- 
box for immediate display, when the mailbox owner 
is accepting messages. Users can be given this permis- 
sion to allow direct, user-to-user communication. 

SIMPLE COMMANDS 

Tlie electronic mail faciUty utilizes standard 
Level 68/DPS system commands to send messages 
and to deliver and receive mail. Other standard file 



manipulation tools allow maintenance of online 

message and mail files. These commands can he 
issued either in full or abbreviated format. Repre- 
sentative Multics commands include: 

• mail (ml) - sends mail to another system user or 
prints the mail in the owner's mailbox. A user's 
mailbox is created autoinatically under the homo 
directory the first time this connnand is invoked. 
Optional arguments allow selective display or dele- 
tion of mail. 

• accepUuessage (am) restores the immediate 
display of tnessages as received; cancels the defer 
message command. 

• immediatejnessage - requests immediate display 
of any messages in an owner's mailbox or of any 
messages received while the owner's terminal is on- 
line, unless the' def^r message is in effect. 

• defeiu^iessagc (dm) prevents any messages 
received while a User's terminal is online from 
inmiediate display and stores them in llie u.ser's 
mailbox. 

• print message (pm) - displays any messages 
received in a user's mailbox during a period when 
messages are not being accepted. 

• send message (sm) sends a niessaue which is 
designated by the person and project identities 
that follow the command. 

• seiiLljnessagiijic knowledge sends a message \o 
the system user(s), designated by person and proj- 
i^^t identifiers that follow the command. When the 
message is displayed at the recipient's terminal, an 
acknowledgment is returned to the sender. 

SYSTEM REQUIREMENTS 

Tlie electronic mail facility is integrated with the 
other facilities of the Level 68/DPS. including data 
base management, text entry and editing, documenl 
formatting, list processing, artwork generation, 
photocomposition, output control, archive storage 
tools, and administrative tools. Uleclronic nuiil Iuik- 
tions on all performance levels of the Level 68/ DPS 
system. 



Specifications may change us design improvements are introdiu cd. 
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In 1964 planning began on the development of a proto- 
type of a computer utility. The aspirations for this system, 
named Multics (for Multiplexed Information and Comput- 
ing Service), were described in papers presented at the 
1965 Fall hint Computer Conference. Implicit in those 
papers was the expectation of a later examination of the 
development effort. From the present vantage point, how- 
ever, it is clear that a definitive examination is beyond 
possibility in a single paper; only some of the possible top- 
ics can be discussed. First we will review the goals, history 
and current status of the appearance of the Multics system 
to its various classes of users. Finally we will describe some 
of the insights which have come out of the development 
activities. 

MULTICS: 
The first 

F J. Corbatd 

Massachusetts Institute of Technology 
Cambridge, MA 

C. T. Clingen 

Honeywell Information Systems Inc. 
Cambridge, MA 

I. H. Saltzer 

Massachusetts Institute of Technology 
Cambridge, MA \ 



FROM THE EDITOR 

This overview and history of Multics will be of excep- 
tional interest because it fills most of the requirements 
for being used as a "software factory", a term that I 
coined in 1 968. It is in fact used for that purpose within 
Honeywell Information Systems in the construction of 
software systems. 

It is particularly pleasing to note that ihe punch card 
has disappeared from the view of Multics programmers, 
although not from everywhere else. As Dr. J. Rabinow 
(of Optical Character Recognition fame) has observed, 
if it does it will be the first product he has seen die while 
on an upward curve of usage! 

This article appeared in the Proceedings of the 1972 AFIPS 
Spring Joint Computer Conference, and is republished (not 
reprinted) here with the permission of AFIPS and the au- 
thors. The work reported herein was sponsored in part by 
Project MAC, an M.l.T. research program sponsored by the 
Advanced Research Projects Agency, Department of De- 
fense, under Office of Naval Research Contract Number 
N00014-70-A-0362-0001. Reproduction is permitted for 
any purpose of the United States Government. 
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INTRODUCTION 

In 1964, following implementation of the Compatible Time- 
sharing System (CTSS) [1,2] serious planning began on the 
development of a new computer system specifically orga- 
nized as a prototype of a computer utility. The plans and 
aspirations for this system, called Multics (for Multiplexed 
/nformatipn and Computing 5ervice), were described in a 
set of six papers presented at the 1 965 Fall joint Computer 
Conferenc e [3-81. The development of the syslenn was un- 
dertaken as a cooperative effort involving the Bell Telephone 
Laboratories (from 1965 to 1969), the Computer Depart- 
ment of the General Electric Company (subsequently ac- 
quired by Honeywell Information Systems Inc.), and Project 
MAC of M.l.T. 

Implicit in the 1965 papers was the expectation that there 
should be a later examination of the development effort. 
From the present vantage point, however, it is clear that a 
definitive examination cannot be presented in a single paper. 
As a result, the present paper discusses only some of the 
many possible topics. First we review the goals, history and 
current status of the Multics project. This review is followed 
by a brief description of the appearance of the Multics sys- 
tem to its various f lasses of users. Finally sever.il topics are 
given which represent some of the research insights which 
have come out of the development activities. This organiza- 
tion has been chosen in order to emphasize those aspects of 
software systems having the goals of a computer utility 
which we feel to be of special interest. We do not attempt 
detailed discussion of the organization of Multics; that is the 
purpose of specialized technical books and papers (for ex- 
ample, the essential mechanisms for much of the Multics 
system are given in books by Organick [9] and Watson { 1 0j). 



COALS 

The goals of the computer utility, although stated at length 
in the 1965 papers, deserve a brief review. By a computer 
utility it was meant that one had a community computer 
facility with: 

■ Convenient remote terminal access as the normal 

mode of system usage. 

■ A view of continuous operation analogous to that of 
the electric power and telephone companies. 

■ A wide range of capacity to allow growth or con- 
traction without either system or user reorganization. 

■ An internal file system so reliable that users trust their 
only copy of programs and data to be stored in it. 

■ Sufficient control of access to allow selective sharing 
of information. 



i The ability to structure hierarchically both the fogit al 
storage of information as well as the administration of 
the system. 

■ The capability of serving large and small users without 
inefficiency to either. 

■ The ability to support different programming environ 
ments and human interfaces within a single system 

■ The flexibility and generality of system organi/ation 
required for evolution through successive waves of 
technological improvements and the inevitable 
growth of user expectations. 

In an absolute sense the above goals are extremely diffic ult 
to achieve. Nevertheless, it is our belief that Multit s, .is il 
now exists, has made substantial progress towards .u hioving 
each of the nine goals (to the best of our knowledge, (he only 
other attempt to comprehensively attack all of these go.ils 
simultaneously is the TSS/30 project at IBM | II, 1 2, 1 )\). 
Most importantly, none of these goals had to be compro 
mised in any important way. 



HISTORY OF THE DEVELOPMENT 

As previously mentioned, the Multics project got underway 
in the Fall of 1 964. The computer equipment to l>e used was 
a modified General Electric 635 which was later named (ho 
645. The most significant changes made were in the pro 
cessor addressing and access control logic where p.iging .uid 
segmentation were introduced. A completely new (ienrr.il 
Ized Input Output Controller was designed and im()lemeni»«<l 
to accommodate the varied needs of devices sue h as disks, 
tapes and teletypewriters without f)resenting ,ui excessive 
interrupt burden to the processors. To handle \ho exjK'tled 
paging traffic, a 4-inillion word (3()-l)it) high-perlortnanct' 
drum system with hardware queueing was cjev(<lop(>cl. The 
design specifications for these items were completed by I all 
1965, and the equipment became available for software 
development in eady 1967. 

Software preparation underwent several phases. The first 
phase was the development and blocking out of major ide.is, 
followed by the writing of detailed program nfoduir spe< ifi 
cations. The resulting 3,000 typewritten pages formed the 
Multics System Programmer's Manual and serv(>(l .is (h(> 
starting point for all programming. Furthermore, the software 
designers were expected to implement their own designs. As 
a general policy PL /I was used as the system programming 
language wherever possible to maximize lucidity and ni.iin- 
tainability of the system |14, 15). This policy also increased 
the effectiveness of system programmers by allowing eac h 
one to keep more of the system within his grasp. 

The setond major t)hase of software development, well 
underway by early 1 967, was that of module implemenia 
tion and unit che( kout followed by merging into larger .ig 
gregates for integrated liMing. Lip lo tln'ii most scWiwar*' .ind 
hardware diffic ullies h.id been aniic ip.iled on ihe h.isis ol 
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previDus experience. But what gradually became apparent 
as the module integration continued was that there were 
gross discrepancies between actual and expected perfor- 
mance of the various logical execution paths throughout the 
software. The result was that an unanticipated phase of de- 
sign iterations was necessary. These design iterations did not 
mean that major portions of the system were scrapped with- 
out being used. On the contrary, until their replacements 
could be implemented, often months later, they were cru- 
cially necessary to allow the testing and evaluation of the 
other portions of the system. The cause of the required 
redesigns was rarely "bad coding", as most of the system 
programmers were well above average ability. Moreover the 
redesigns did not mean that the goals of the project were 
compromised. Rather three recurrent phenomena were ob- 
served: 1 ) typically, specifications representing less-impor- 
tant features were found to be introducing much of the 
complexity, 2) the initial choice of modularity and interfac- 
ing between modules was sometimes awkward, and 3) it 
was rwliscovered that the most important property of al- 
gorithms is simplicity rather than special mechanisms for 
unusual cases. ("In anything at all, perfection is finally at- 
tained not when there is no longer anything to add, but when 
there is no longer anything to take away..." - Antoine de 
Saint-Exup4ry, Wind Sand and Slars, Quoted with permis- 
sion of f larcourt Brace jovanovich. Inc.) 

The reason for bringing out in detail the above design 
iteration experience is that frequently the planning of large 
software projec ts still does not properly lake the need for 
continuing iteration into account. And yet we believe that 
design iterations are a required activity on any large scale 
system which attempts to break new conceptual ground 
such that individual programmers cannot comprehend the 
entire system in detail. For when new ground is broken, it is 
usually impossible to deduce the consequent system behav- 
ior except by experimental operation. Simulation is not par- 
ticularly effective when the system concepts and user 
behavior are new. Unfortunately one does not understand 
the system well enough to simplify it correctly and thereby 
obtain a manageable model which requires less effort to 
implement than the system itself, instead one must develop 
a different view: 

■ The initial program version of a module should be 
viewed only c>s the first com[)lete specific ation of the 
module ,ind should be sul)ject to design review boforo 
being debugged or chec ked out. 

■ Module design and implementation should be based 
upon an assumption of periodic evaluation, redesign, 
and (^volution. 

In retrospect, the design iteration effect was apparent even 
in the development of tlie earlier Compatible Timesharing 
System (CTSS), when a second file system with many func- 
tional improvements turned out to have poor performance 
when initially installed. A hasty design iteration succeeded 
in rectifying the mailer but the episode at the time was 
viewed as an anomaly perhaps due to inadequate technic al 
r('vi(>vv of individual programming efforts. 



CURRENT STATUS 

in spite of the unexpected design iteration phase, the Multics 
system became sufficiently effective by late 1 968 to allow 
system programmers to use the system while still developing 
it. By 1969 October, the system was made available for 
general use on a "cost-recovery" charging basis similar to 
that used for other major compulation facilities at M.l.T. 
Multics is now the most widely used timesharing system at 
M.I.T., supporting a user community of some 500 registered 
subscribers. The system is currently operated for users 22 
hours per day, 7 days per week. Fo"" at least eight hours eac h 
day the system operates with two processors and thrc>e 
memory modules containing a total of 384 K (K=1024) 36- 
bit words. This configuration currently is rated at a capacity 
of about 55 faidy demanding users such that most trivial 
requests obtain response in one to five seconds. (Future 
design iterations are expected to increase the capacity rat- 
ing.) Several limes a day during the off-peak usage hours the 
system Is dynamically reconfigured into two systems: a re- 
duced capacity service system and an independent develop- 
ment system. The development system is used for testing 
those hardware and software changes which c.uinot be 
done under normal service operation. 

The reliability of the round-the-clock system operation 
described above has bcvn a matter of grcMl concern, for in 
any online real-time system the impact of misha[)s is usually 
far more severe than in batch processing systems. In .in 
online system especially important consicierations are: 

■ the lime required before the system is usable agam 
following a mishap 

■ ihe extra prc*cautions required for rc^storing possibly 
lost files 

■ the psychological stress of breaking the interactive 
dialogue with users who were counting on system 
availability 

Because of the importance of these considerations, careful 
logs are kept of all Multics "crashes" (i.e., system servic e 
disruption for all active users) at M.l.T. in order that analysis 
can reveal their c ausers. These analyst's indicate c iirrenily an 
average of between one and two c rashes per 24 hour d.iy." 
These crashes h.ive no single cause. Some are due to h.ird- 
ware failures, others to opivalor error and still others to 
software bugs introduc ckJ during the course of cievelopment. 
At the two other sites where Multics is operalecJ, l)ut where 
ac tive system development does not take place, there h.we 
been almost no system failures traced to software. 

Currently the Multics system, including compilers, com- 
mands, and subroutine libraries, consists of about 1500 
modules, averaging roughly 200 lines of PL /I apitne. These 
compile to produce some 1,000,000 words of procedure 
code. Another system measure is the s\7x^ of the rc^sicfent 
supervisor which is about 30 K words of procedure .ind, for 
a 55 user load, about 36 K words of data and buffer areas. 

Because the system is so huge, the most powerful mainte- 
nance tool available was c hosen-thc> system ilsclf. With all 
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of the system modules stored online, it is easy to manipulate 
the many components of different versions of the system. 
Thus it has been possible to maintain steadily for the last year 
or so a pace of installing 5 or 1 0 new or modified system 
modules a day. Some three-quarters of these changes can be 
installed while the system is in operation. The remainder, 
pertaining to the central supervisor, are installed in batches 
once or twice a week. This online maintenance capability 
has proven indispensible to the rapid development and 
maintenance of Multics since it permits constant upgrading 
of the user interface without interrupting the service. We are 
just beginning to see instances of user-written applications 
which require this same capability so that the application 
users need not be interrupted while the software they are 
using is being modified. 

The software effort which has been spent on Multics is 
difficult to estimate. Approximately 150 man-years were 
applied directly to design and system programming during 
the "development-only" period of Table I. Since then we 
estimate that another 50 man-years have been devoted to 
improving and extending the system. But the actual cost of 
a single successful system is misleading, for if one starts 
afresh to build a similar system, one must compensate for the 
non-zero probability of failure. 



THE APPEARANCE OF MULTICS 
TO iTS USERS 

Having reviewed the background of the project, we may 
now ask who are the users of the Multics system and what 
do the facilities that Multics provides mean to these users. 
Before answering, it is worth describing the generic user as 
"viewed" by Multics. Although from the system's point of 
view all users have the same general characteristics and 
interface with it uniformly, no single human interface repre- 
sents the Multics machine. That machine is determined by 
each user's initial procedure coupled with those functions 
accessible to him. Thus there exists the potential to present 
each Multics user with a unique external interface. 

However, Multics does provide a native internal program 
environment consisting of a stack-oriented, pure-procedure, 
collection of PL /I procedures imbedded in a segmented vir- 
tual memory containing all procedures and data stored on- 
line. The extent to which some, all, or none of this internal 
environment is visible to the various users is an administra- 
tive choice. 



The implications of these two views -both the cxtern.il 
interface and the internal progr.imming cnvironniicni -.ir«« 
discussed in terms of the following catogories of users: 

■ System and user application programmers responsi- 
ble for writing system and user software. 

■ Administrative personnel responsible for the manage- 
ment of system resources and privileges. 

■ The ultimate users of application systems 

■ Operations and hardware maintenance personnel re- 
sponsible, respectively, for running the machine 
room and maintaining the hardware. 

Multics as Viewed by System and 
Subsystem Programmers 

The machine presented to both the Multic s system program 
mer and the applic<ilion system f)rogramiiier is the <>n(> with 
which we have the most experience; it is the raw mafi-rial 
from which one constructs other environments. It is worth 
re-emphasi/ing that the only differentiation between Multi( s 
system programmers and user [)rogrammers is enthodied in 
the access control mec hanism whic h (k'lerniines wh.it on 
line information can l)e referenc eel; therefore*, wh.u ar<* .»p 
parently two groups of users c an be disc ussed as one. 

Major interfaces prc^sentc^d to programmers on the Mullic s 
system can be classified as the program preparation and 
documentation facilities and the program execution and 
debugging environment. They will be touched upon briefly, 
in the order used for program preparation. 

■ Program Preparation and Documentation 

The facilitic^s for program preparation on Mullic s are typic al 
of those found on othc^r timesharing systems, with some 
shifts in emphasis. (See the Appendix.) f or example, pro 
grammers consider the file system suffic ienlly invu!iier.il)!(> 
to physic ,il loss that it is used c asually and rt)ulinel^' to save 
all information. Thus, the punched card has v.inished (lom 
the work routine of Multics programmers ,ind ,u<ess lo 
one's programs and thc» ability lo work on ihem .ire piovided 
by the c losesi lennittal. 



System 

CTSS 

Multics 



Development Only 
1960-1963 
1964-1969 



Development + Use 
1963-1965 
T969-present 



Use Only 



1 965-present 



Table I. A comparison of the system cJevelopment and use periods oi CTSS and Multics. The Multics development period is not significanlly longer th.in 
that for CTSS despite the development of alxjul 10 limes as much code for Multics as for CTSS and a geographically distributed staff. Although ri\json> 
for this similarity in time span include the use of a higher-level programming language and a somewhat larger staff, the uh' of CTSS as a development kniI 
for Multics was of pivotal importance. 
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AS .inothor example, the full ASCII character set is em- 
()l()yed in preparing programs, data, and documentation, 
th(»rt*l)y eliminating the need for multiple text editors, several 
varieties of text formatting and comparison programs, and 
multiple facilities for printing information both online and 
offline. This generalization of user interfaces facilitates the 
learning and subsequent use of the system by reducing the 
number of conventions which must be mastered. 

Finally, because the PL/ 1 compiler is a large set of pro- 
grams, considerable attention was given to shielding the user 
from the size of the compiler and to aiding him in mastering 
the complexities of the language. As in many other timeshar- 
ing systems, the compiler is invoked by issuing a simple 
command line from a terminal exactly as for the less ambi- 
tious commands. No knowledge is required of the user re- 
garding the various phases of compilation, temporary files 
required, and optional capabilities for the specialist; explana- 
tory "sermons" diagnosing syntactic errors are delivered to 
the lertninal to effect a self-teaching session during each 
compilation. To the programmer, the PL /I compiler is just 
another command. 



■ Program Execution Environment 

Another set of interfaces is embodied in the implementation 
environment seen by PL/I programmers. This environment 
consists of a directly addressable virtual memory containing 
the entire hierarchy of online information, a dynamic linking 
facility which searches this hierarchy to bind procedure ref- 
erences, a device-independent input/output |16l system 
(the Michigan Termihat System (17) has a similar device- 
independent input /output system) and program debugging 
and metering facilities. These facilities enjoy a symbiotic 
relationship with the PL/I procedure environment used both 
to implement them and to implement user facilities co-exist- 
ing with them. Of major significance is that the natural inter- 
nal environment provided and required by the system is 
exactly that environment expected by PL/ 1 procedures. For 
example, PL/i pointer variables, call and return statements, 
conditions, and static and automatic storage all correspond 
directly to mechanisms provided in the internal environ- 
ment. Consequently, the system supports PL/I code as a 
matter of course. 

The main effect o( the corr^bination of these* fe.itures is to 
permit the implementer to spend his time concentrating on 
the logic of his problem; for the most part he is freed from 
the usual mechanical problems of storage management and 
ovedays, input /output device quirks, and machine-depend- 
ent features. 



procedures and about 125 K words of object code. Four 
people implemented this compiler in two years, from start to 
first genera! use. The first version of the Multics prograirt 
debugging system, composed of over 3,000 lines of source 
code, was usable after one person spent some six months of 
nights and weekends "bootlegging" its implementation. As 
a last example, a facility consisting of 50 procedures with a 
total of nearly 4,000 PL/I statements permitting execution of 
Honeywell 635 programs under Multics became operational 
after one person spent eight months learning about the 
GCOS operating system for the 635 PL/I, and Multics, and 
then implemented the environment. In each of these exam- 
ples the implementation was accomplished from remote ter- 
minals using PL/I. 

Multics users have discovered that it is possible to get their 
programs running very quickly in this environment. They 
frequently prepare "rough drafts" of programs, execute 
them, and then improve their overall design and oper.iting 
strategy using the results of experience obtained during ac - 
tual operation. As an example, again drawn from the imple- 
mentation of Multics, the early designs and implementations 
of the programs supporting the virtual memory [18) made 
over-optimistic use of variable-sized storage allocation tech- 
niques. The result was a functionally correct but inade- 
quately performing set of programs. Nevertheless, these 
modules were used as the foundation for subseciueni work 
for many months. When they were finally replac(>ci with 
modules using simplified fixed-size storage tec hnicjues, per- 
formance improvements of over an order of magnitude were 
realized. This technique emphasizes two points: first, it is 
frequently possible to provide a practtca}, mable fac itily c on- 
taining temporary versions of programs; second, often the 
insight required to significantly improve the behavior of a 
program comes only after it is studied in operation. As im- 
plied in the earlier discussion of design iteration, our experi- 
ence has been that structural and strategic changes rather 
than "polishing" (or recoding in assembly language) produc e 
the most significant performance improvements. 

In general, we have noticed a significant "amplifier" or 
"leverage" effect with the use of an effective online environ- 
ment as a system programming facility. Major implementa- 
tion projects on the Multics system seldom involve more 
than a few programmers, thereby easing the management 
and communications problems usually entailed l)y complex 
system implem(>ntations. As would be expec led, the amplifi- 
cation effect is most apparent with the best projcu t person- 
nel. 



■ Some Implementation Experience 

The Multics team began to be much more produc five once 
the Multics system became useful for software development. 
A few c ases are worth citing to illustrate the effet tiveness of 
the implementation environment. A good example is the 
current PL/i compiler, which is the third one to be imple- 
mented for the prc)ject, and whic h consists of some 250 



Administration of Multics 
Facilities and Resources 

The problem of managing the capabilities of a computer 
utility with geographically disperst^d subscril)(>rs Ic.ids to .i 
requirement of decentralized administration. At the .ipex of 
an administrative pyramid residt^s a system .idminislralor 
with the ability to register new users, confer resource (|uolas. 
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and generate periodic bills for services rendered. The system 
administrator deals with user groups called projects. Each 
group can in turn designate a project administrator who is 
delegated the authority to manage a budget of system re- 
sources on behalf of the project. The project administrator 
is then free to deal directly with project members without 
further intervention frism the system administrator, thereby 
greatly reducing the bottlenecks inherent in a completely 
centralized administrative structure. 



■ Environment Shaping 

In addition to having immediate control of such resources as 
secondary storage, port access, and rate of processor usage, 
the project administrator is also able to define or shape the 
environment seen by the members of his project when they 
log into the system. He does this by defining those proce- 
dures that can be accessed by members of his project and 
by specifying the initial procedure executed by each mem- 
ber of his project when he logs in. This environment shaping 
facility has led to the notion of a private project subsystem 
on Multics. It combines the administrative and programming 
facilities of Multics so that a project administrator and a few 
project implementers can build, maintain, and evolve envi- 
ronments entirely on their own. Thus, some subsystems bear 
no internal resemblance to the standard Multics procedure 
environment. 

For example, the Dartmouth BASIC |19| compiler exe- 
cutes in a t josed subsystem implemented by an M.l.T. stu- 
dent group for use by undergraduate students. The compiler, 
its object code, and all support routines execute in a simula- 
tion of the native environment prcjvided ,\\ Dartmouth. The 
users of this subsystem ne*ed little, if any, knowledge of 
Multics and are able to behave as if logged into the Dart- 
mouth system proper. Other examples of controlled envi- 
ronment subsystems include one to permit many programs 
which normally run under the CCOS operating system to 
also run unmodified in Multics. Finally, an APL |20j subsys- 
tem allows the user to behave for the most part as if he were 
logged into an APL machine. The significance of these sub- 
systems is that their implementers did not need to interact 
with the system administrator or to modify already existing 
Multics capabilities. The administrative facilities permit each 
such subsystem to be offered by its supporters as a private 
service with its own group of users, each effectively having 
its own private computer system. 

Other Multics Users 

Finally, we observe that the roles of the application user, the 
system operators and the hardware maintainers as seen by 
the system are simply those of ordinary Multics users with 
specialized access to the online procedures and data. The 
eftec t of this uniformity of treatment is to reduce greatly the 
mainlcMMtUf burden of the svstem control software. One 
example, ot great practical inifjortanc i>, has bovn (he cMse 
with whic h system pertormancc nuMsuremetit tools have 
been prepared for use by the o[)erating staff. 



INSIGHTS 

So far, we have discussed the status and appearance of the 
Multics system. A further question is what has been learned 
in the construction of Multics which is of use to the designers 
of other systems. Having a bright idea which c learly solves 
a problem is not sufficient cause to claim a contribution if the 
idea is to be part of a complex system. In order to establish 
the real feasibility of an idea, all of its implications and conse- 
quences must be followed out. Much of the work on Multics 
since 1 965 has involved following out implications and con- 
sequences of the many ideas then proposed for the proto- 
type computer utility. That following out is an essential part 
of proof of ideas is attested by the difficulties which have 
been encountered in other engineering efforts such as the 
development of nuclear fusion power plants and the electric 
automobile. Not all proposals work out; for example, ex- 
tended attempts to engineer an atomic powered airplane 
suggest infeasibility. 

Perhaps Multics' most significant single contribution to the 
state of the art of computer system construction is the dem 
onstration of a large set of fully implemented idcMs in a 
working system. Further, most of these ideas have been 
integrated without straining the overall design; most addi- 
tional proposals would not topple the structure. Ideas such 
as virtual memory access to online storage, parallel process 
organization, routine but controlled information sharing, dy- 
namic linking of procedures, and high-level language imple- 
mentation have proven remarkably compatible and 
complementary. 

To illustrate some of the areas of progress in understanding 
of system organization and construction which hav(> been 
achieved in Multics, we consider here the following five 
topics: 

■ Modular division of responsibility 

■ Dynamic reconfiguration 

■ Automatically managed multilevel memory ' 

■ Protection of programs and data 

■ System programming language 

Modular Division of Responsibility 

Early in the design of Multics a decision had to be made 
whether or not to treat the segmented virtual memory as a 
separately usable "feature", independent of a traditionally 
organized read /write type file system. The alternative, to use 
the segmented virtual memory as the file system itself, pro- 
viding the illusion of direct "in-core" access to all online 
storage, was certainly the less conservative approach (Fig. 
1 ). The second approach, which was the one chosen, led to 
a strong test of the ability of a computing system to support 
an apparent one-level memory for an arbitrarily large infor- 
mation base. It is interesting that the resulting almost total 
decoupling between physical storage allocation and data 
tiiovement on the one hand and directory structure, naming, 
and file organization on the other led to a remarkably simple 
and functionally modular structure* for that f)art of [hv system 
1181 (Fig. 2). 
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Figure 1. The entire stnraKe hierarchy rridy be m.ipped into Individual user 
prottvis address sptices (see arrows) as if contained in a primary memory. 
llliiMrattKl are lite sharing of a sup(>rvisor segment by two users and private 
acti'ss to sejintetils a and b. The necessary primary storane is simulated by 
a demand paging technique which nMJves information between the real 
primary memory and secondary sttwuige. 
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Figure 2. Major lines of mcHlular division in Mullits. Solid lines inclit.ilf 
I. ills lor services Dotted lines indiiale impliiil usi- (jf lhi> virtual pneniory. 



Another' area of Multics in which a high degree of func- 
tional modularity was achieved was in scheduling, multipro- 
gramming, and processor management. Because harnessing 
of multiple processors was an objective from the beginning, 
a careful and methodical approach to multiplexing pro- 
cessors, handling interrupts, and providing interprocess syn- 
chronizing primitives was developed. The resulting design, 
known as the Multics traffic controller, absorbed into a sin- 
gle, simple module a set of responsibilities often diffused 
among a scheduling algorithm, the input /output controlling 
system, the online file management system, and special pur- 
pose inter-user communication mechanisms (21 ]. 

Finally, with processor management and online storage 
management uncoupled into well-isolated modules, the 
Multics input/output system was left with the similarly isola- 
lable function of managing streams of data flowing from and 
to source and sink type devices (16). Thus, this sec lion of the 
system concentrates only on switching of the stre.tms, allo- 
cation of data buffering areas, and device control sir.itcgics. 

Each of the divisions of labor described above represents 
an interesting result primarily because it is so diffic ult to 
discover appropriate divisions of complex systems. (See 
Dijkstra [22] for a further discussion of this point). Establish- 
ing that a certain proposed division results in simplicity, 
creates an uncluttered interface, and does not interfere with 
performance, is generally cause for a minor celebration. 



Dynamic Reconfiguration 

If the computer utility is ever to become as xnuch a rcMlily 
as the electric power utility or the telephone communication 
service, its continued operation must not be dependent upon 
any single physical component, since individual comf)onents 
will eventually require maintenance. This observation leads 
an electric power utility to provide procedures whereby an 
idle generator may be dynamically added to the utility's 
generating c apacity, while another is removed for m.tinte 
nance, all without any disruption of service to c uslomers. A 
similar scenario has long been proposed for multiproc essor, 
multimemory computer systems, in which one would 
dynamically switch processors and memory boxes in and 
out of the operating configuration as needed. Unfortunately, 
though there have been demonstrated a few "special pur- 
pose" designs (an outstanding example is the American Air- 
lines SABRE system [23|) it has not been apparent how to 
provide for such operations in a general purpose system. A 
recent thesis [24J proposed a general model for the dynamic 
binding and unbinding of computation and memory struc- 
tures to and from ongoing computations. Using this model 
as a basis, the thesis also proposed a specific implementaiiof i 
for a typical multiprocessor, multimemory computing sys- 
tem. One of the results of this work was the addition to the 
operating Multics system of the capability of dynamically 
adding and removing central processors and memory 
modules as in Figure 3. The usefulness of the iciea may be 
gauged by observing that at M.l.T. five to ten such reconfigu- 
rations are performed in a typical 24-hc)ur operating day 
Most of the reconfigurations are used to provide a secondary 
systein for Multics developmcvit. 
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■ A strategy to treat core memory, drum, and disk as a 
three-level system has been proposed, including a "least- 
recently-used" algorithm for moving information from 
drum to disk. Such an algorithm has been used for some 
time to determine which pages should be removed from 
core memory [27|. The dynamics of interaction among 
two such algorithms operating at different levels are 

J weakly understood, and some experimental work should 
provide much insight. The proposed strategy will be im- 
plemented, and then compared with the simpler present 
strategy which never moves things from drum to disk, 
but instead makes educated "guesses" as to which de- 
vice is most appropriate for the permanent residence of 
a given page. If the automatic algorithm is at least as good 
as the older, static one, it would represent an improve- 
mer>t in overall design by itself, since it would automati- 
cally track changes in user behavior, while the static 
algorithm requires attention to the validity of its guesses. 
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lypic.ll optTOting configurations shown hero, wUhoul curriMilly logged-in 
iisfrs lM>ing .iw<iri> that a change ha> lal<en place. 



A scheme to permit experimentation with predictive 
paging algorithms was devised. The scheme provides for 
each process a list of pages to be preloaded whenever 
the process is run, and a second list to be immediately 
purged whenever the process stops. The updating of 
these lists is controlled by a decision table exercised 
every time the process stops running. As every |>age of 
the Multics virtual memory is potentially shared, the de- 
cision table represents a set of heuristics designed to 
separate out those which are probably not being shared 
at the moment. 

A series of measurements was made to establish the 
effectiveness of a small hardware associative memory 
used to hold recently accessed page descriptors These 
measurements established a profile of hit ratio (proba- 
blity of finding a page descriptor in the associative mem- 
ory) versus associative memory size which should be 
useful to the designer of virtual memory systems (28j. 



Automatically Managed Multilevel Memory 

By now it has become accepted lore in the computer system 
field that the use of automatic management algorithms for 
memory systems c onstructed of several levels with different 
access times can provide a significant reduction of user pro- 
gramming effort. Examples of such .lutomatic management 
strategies include the buffer memories of the IBM system 
;i7() models 1 55, 1 65, and 1 95 |25| and the demand |)aging 
virtual memories of Multics, IBMs CP-()7 |2b| and the Michi- 
gan Terminal System |17j. Unfortunately, behind the mask 
of ac c optanc o hides a worrisome lack of knowledge about 
how to engineer a multilevel memory system with appr()[)ri- 
ate strategy algorithms which are matched to the load and 
hardware* characteristics. One of the goals of the Multics 
projec t h.>s been to instrument and experiment with th<' 
multilevel incMiiory system of Multic s, in order to learn In'lter 
how to predic t in advance the pt>rformanc t* of proposed 
new .tulomalic ally managed mulllleve! memory sysleins 
Several s|)ecific aspects of this goal have been explort*d: 



■ A set of models, both analytic and simulation, was con- 
structed to try to understand program behavior in a vir- 
tual memory. So far, two results have been obtained. 
One is the finding that a single program characteristic 
(the mean execution time before encountering a "miss- 
ing" page in the virutal memory as a function of memory 
size) suffices to provide a quite accurate prediction of 
paging and idle overhead times. The second is a direct 
calculation of the distribution of response times under 
multiprogramming. Having available the entire response 
time distribution, rather than just averages, permits esti- 
mation of the variance and 90-percentile points of the 
distribution, which may be more meaningful than just the 
average. A doctoral thesis is in progress on this topic. 

Although the immediate effect of each of these investiga- 
tions is to improve the understanding or performance of the 
current version of Muitics, the long-range payoff in inelhodi 
cal engineering using better understood memory strut tures 
is also evident. 



10 HONEYWELL COMPUTER JOUHNAL 



C-8 



Protection of Programs and Data 

A long-standing objective of the public computer utility has 
been to provide facilities for the protection of executing 
programs from one another, so that users may with confi- 
dence place appropriate control on the release of their pri- 
vate information. In 1967, a mechanism was proposed [29] 
and implemented in software which generalized the usual 
supervisor-user protection relationship. This mechanism, 
named "rings of protection", provides user-written subsys- 
tems with the same protection from other users that the 
supervisor has, yet does not require that the user-written 
subsystem be incorporated into the supervisor. Recently, 
this approach was brought under intense review, with two 
results: 

■ A hardware architecture which implements the 
mechanism was proposed [30]. One of the chief fea- 
tures of the proposed architecture is that subroutine 
calls from one protection ring to another use exactly 
the same mechanisms as do subroutine calls among 
procedures within a protection area. The proposal 
appears sufficiently promising that it is included in the 
specifications for the next generation of hardware to 
be used for Multics, 

■ As an experiment in the feasibility of a multilayered 
supervisor, se:veral supervisor procedures which re- 
quired protection, but not all supervisor privileges, 
were moved into a ring of protection intermediate 
between the users and the main supervisor. The suc- 
cess of this experiment established that such layering 
is a practical way to reduce the quantity of supervisor 
code which must be given all privileges. 

Both of these results are viewed as steps toward first, a more 
complete exploitation and understanding of rings of protec- 
tion, and later, a less constrained organization of the type 
suggested by Evans and LeClerc [31] and by Lampson [32].. 
But more importantly, rings of protection appear applicable 
to any computer system using a segmented virtual memory. 
Two doctoral theses are underway in this area. 



System Programming Language 

Another technique of system engineering methodology be- 
ing explored within the Multics project is that of higher level 
programming language for system implementation. The ini- 
tial step in this direction (which proved to be a very big step) 
was the choice of the PL/I language for the implementation 
of Multics. By now, Multics offers an extensive case study 
in the viability of this strategy. Not only has the cost of using 
a higher level language been acceptable, but increased main- 
tainability of the software has permitted mort« rapid evolu- 
tion of the syslen) in r('S(K)nse to dcvclopinenl ideas as well 
as user nviKis. Three specific .isfKH ts of this experienc i* have 
now been t oniplftod: 



■ The transition from an early PL/I subset compiler [ 1 4 1 
to a newer compiler which handles almost the entire 
language was completed. This transition was c arried 
out with performance improvement in practically ev- 
ery module converted in spite of the larger language 
involved. The significance of the transition is the 
demonstration that it is not necessary to narrow one's 
sights to a "simple" subset language for system pro- 
gramming. If the language is thoroughly understood, 
even a language as complex as the full PL/ 1 can be 
effectively used. As a result, the same language and 
compiler provided for users can also be used for 
system implementation, thereby minimizing mainte- 
nance, confusion, and specialization. 

■ Notwithstanding the observation just made, the time 
required to implement a full PL/I compiler is still too 
great for many situations in which the compiler im- 
plementation cannot be started far enough in ad- 
vance of system coding. For this reason, there is 
considerable interest in defining a smaller langu.igc 
which is easily compilable, yet retains the ItMtures 
most important for system implementation. On the 
basis of the experience of programtning Multii s in a 
subset of PL /I, such a language was defined but nt)t 
implemented, since it was not needed | i3|. 

■ A census of Multics system modules reve.ils how 
much of the system was actually coded in PL/I, and 
reasons for use of other languages. Roughly, of the 
1500 system modules, about 250 were wrttlt^Y tn 
machine language. Most of the machine language 
modules represent data bases or small sul)r<)ulines 
which execute a single privileged instruction. (No at- 
tempt was made to provide either a data base com- 
piler or PL/I built-in functions for specialized 
hardware needs.) Significantly, only a half dozen 
areas (primarily in the traffic controller, the central 
page fault path, and interrupt handlers) whic h were 
originally written in PL/I have been reccKleci in ma- 
chine language for r(\isons of squeezing out the ut- 
most in performance. Several programs, originally in 
machine langu<ige, have l)een recoded in PI /I to in- 
crease their maintainability. 

As with the earlier to[)ics, the implications of this work with 
PL/I should be felt far beyond the Multics system. Most 
implementers, when faced with the economic uncertainties 
of a higher-level language, have chosen mac hine language 
for their central operating systems. The experience of using 
PL/I for Multics, when atidtxi io the expanciing c oikn (ioti ot 
experience elsewhere |34|, should help rc^duc e the uncer- 
tainty. 

In a rc^search projec t as largc\ long, and complc^x as Mul- 
tics, any p.iper such as this must necessarily omit m.uiy 
CKjualiy significant ideas, and louc h only a few whic h may 
happen Io have wide current inleiest. ii is the purpose ot 
individual and detailed tec linic ai papers Io explain lliese and 
other ideas niore fully. I he bibliography loiind in icleience 
I iS \ contains over twentv such technical papers. 
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IMMEDIATE FUTURE PLANS 

The Multics software is continuing to evolve in response to 
user needs and improved understanding of its organization. 
In 1 972 a new hardware base for Multics will be installed by 
the Information Processing Center at M.l.T. for use by the 
M.l.T. computing community. This program compatible 
hardware base contains small but significant architectural 
extensions to the current hardware. The circuit technology 
used will be that of the Honeywell 6080 computer. The 
substantial changes include: 

■ Replacement of the paging drum initially with bulk 
core and, when available, LSI memory. 

■ Implementation of rings of protection as part of the 
paging and segmentation hardware. 

Wherever possible the strategy of using off-the-shelf stan- 
dard equipment rather than specially engineered units for 
Multics has been followed. This strategy is intended to sim- 
plify maintenance. 



CONCLUSIONS 

There are many conclusions which could possibly be drawn 
from the experience of the Multics project. Of these, v/c 
consider four to be major and worthy of note. First, we feel 
it is clear that it is possible to achieve the goals of a prototype 
computer utility. The current implementation of Multics pro- 
vides a measure of the mechanisms required. Moreover, the 
specific implementation of the system, because it has been 
written in PL/I, forms a model for other system designers to 
draw upon when constructing similar systems. 

Second, the question of whether or not the specific soft- 
ware features and mechanisms which were postulated for 
effective computer utility operation are desirable has now 
been tested with specific user experience. Although the spe- 
cific mechanisms implemented subsequently may be super- 
seded by better ones, it is certainly clear that the 
improvement of the user environment which was wanted 
has been achieved. 

Third, systems of the computer utility class must evolve 
indefinitely since the cost of starting over is usually prohibi- 
tive and the many-year lead time required may be equally 
unacceptable. The requirement of evolvability places strin- 
gent demands on design, maintainability, and implementa- 
tion techniques. 

Fourth and finally, the very act of creating a system which 
solves many of the problems posed in 1 965 has opened up 
many new directions of research and development. It would 
appear almost a certainty that increased user aspirations will 
continue to require intensive work in the areas of computer 
system principles and techniques. 

In closing, perhaps we should take note th.U in the seven 
years since Multics was proposed, a great many olher sys- 
tems have also been proposed and constructed; many of 
these have developed similar ideas. Some examples which 
have not already been mentioned include; 



■ the TENEX system of Bolt, Beranek and Newman 

■ the VENUS system of Mitre Corp. 

■ the MU5 at Manchester University 
i RC-4000 of Regnecentralen 

■ 5020 TSS of Hitachi Corp. 

■ DIPS-1 of Nippon Telephone 

■ the Japanese National Computer Project 

■ the PDP-10/50 TSS of Digital Equipment Corp. 

■ the CBB-500 of Berkeley Computer Corp. 

■ I.T.S. of the M I T. Artificial Intelligence LahoratvKy 

■ Exec-8 of Univac 

■ System 3 and 7 and the SPECTRA. 70/46 of RCA 

■ Star-100 of CDC 

■ UTS of Xerox Data Systems 

■ the 6700 system of Burroughs 

■ the Dartmouth Timesharing System 

In most cases, their designers have developed effective i,m- 
plementations which are directed to a different interpreta- 
tion of the goals, or to a smaller set of goals ih.in those 
required for the complete computer utility. This diversity is 
valuable, and probably necessary, to accomplish a thorough 
exploration of many individually complex ideas, and therel)y 
to meet a future which holds increasing demand for systems 
which embrace the totality of computer utility requirements. 
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APPENDIX: A CHECKLIST OF 
MULTICS FEATURES 

Following is a c hec klist of c urrenlly available fe.itur(>s and 
facilities of Multics. Although niany of the fe.ilures are (!e 
scribed in cryptic and untranslated local jargon, one ( an at 
least obtain a feel for the range of f.ic ilities now provided 
Further information on most of these features ni.iy he lound 
in the Multics Programmers' Manual 1.15 1, 
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CHECKLIST OF MULTICS FEATURES 

Interactive Time-Sharing Facilities 

■ file editors 

■ file manipulation (rename/ move/delete) 

■ personal command abbreviations 
> recursive command language 

■ source language debugging with breakpoints 

■ subroutine call tracer 

■ can stop any running command or program 

Programming Languages 

■ PL/I 

■ FORTRAN 

■ BASIC (The BASIC system and the Dartnrwuth envi- 
ronment were developed at Dartmouth College. 
Used at M.l.T. by permission of Dartmouth College.) 

■ APL 

■ LISP 

■ BCPL 

■ ALM (assembly language/ Mullics) 

Information Storage System 

■ configuration independent 

■ accessed through virtual memory (segments) 

■ access control lists by user and project 

■ links to segments of other users 

■ hierarchical directory (catalog) arrangements 

■ public library facilities 

■ sharing at all levels 

■ multiple segment names (synonyms) 

■ separate control of read, write, and execute 



Programming Environment 

■ segmented virtual memory 

■ dynamic linking of procedures and data, or prelinking 

■ interprocess communication 

■ independent of configuration 

■ uniform error handling mechanism 

■ user definable protection rings 

■ microsecond calendar clock with interrupt 

■ program interrupt signal from console 



Input and Output 

■ standard typewriter interface for device indepen- 
dence 

■ ASCII character set used throughout 

■ input characters converted to canonical form 

■ erase and kill editing on typed input 

■ I/O streams switchable during execution 

■ magnetic tape, printer, card punch, card reader 

■ typewriter terminals (IBM 2741, 1050; Teletype 37, 
33, 35; Dura; Datel; Execuport; Terminet-300) 

■ graphic support library (devices: ARDS, IMLAC, DEC 
338) 

■ ARPA network 

■ interfaces at {hree levels (formatted data coversion; 
bit stream control; full device control) 



Management facilities 

■ passwords required for login 

■ project may interpose authentication procedure 

■ decentralized projects ^ 

■ accounting, billing, and quotas 

■ online probing and account adjustment 

■ operator or system initiated logout of users 

■ unlisted and anonymous users 

■ limited service system 

■ dynamic reconfiguration of memories and processors 

■ system performance metering for parameter adjust- 
ment 

■ project-imposed starting procedure 

Communication Facilities 

■ interuser mail 

■ help command, help files 

■ message of the day 

■ online error reporting and consultation servic e 

■ online user graffiti board 

■ operations message broadcast to logged-in users 

Absentee Facilities 

■ priority /defer queues for printer, card punch 

■ queued translator facility 

■ general absentee job facility 

Reliability Measures 

■ weekly file copies onto tape 

■ daily disk/drum copy onto tape 

■ incremental file copies onto tape, 1/2 hour bohimi 
use 

■ salvager to clean up files after system crash 

■ emergency shutdown entry to system 

Maintenance Features 

■ online library change, no disruption of current users 

■ entire system source online, maintenance tools 

■ system checkout on small hardware configuration 

■ online performance monitoring of multiprogramming 
(paging traffic; drum/disk usage; typewriter traffic) 

■ user performance feedback (cpu time and paging 
load on each command; page trace always operating; 
subroutine call counters) 

Private Project Subsystems 

■ project-providable command interface 

■ Dartmouth environment (The BASIC system and the 
Dartmouth environment were developed at Dart- 
mouth College. Used at M.l.T. by permission) 

■ student environment 



Miscellaneous Facilities 

■ desk calculators 

■ sort command 

■ memorandum formatting and typing subsystem 

■ user-provided list of progratns to Ih> auionialii ally 
executed when user k)gs iti 

■ CCOS environment 
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FROM THE EDITOR 

This is the information that a new Multics programmer 
receives when he becomes a user at M.l.T. (or else- 
where). This should be of interest in view of impending 
upgrading of the system. 

The next issue of the Honeywell Computer Journal 
will carry a special microfiche devoted to a historical 
potpourri of the major papers on Multics. 



Introduction 

Multics (from Multiplexed Information and Computing 

Service) is the name of a new, general-purpose computer 
system developed by the Computer System Research group 
at M.l.T. Project MAC, in cooperation with Honeywell Infor- 
mation Systems (formerly the General Electric Company 
Computer Department) and the Bell Telephone Laborato- 
ries. This system is designed to be a "computer utility", 
extending the basic concepts and philosophy of the Compat- 
ible Timesharing System (CTSS, operating now on the IBM 
7094 computer) in many directions. Multics is implemont(Hi 
initially on the Honeywell 645 computer system, an en- 
hanced relative of the Honeywell 635 computer. 

One of the over-all design goals of Multics is to ( reale a 
computing system which is capable of meeting almost all of 
the present and near future requirements of a large comfjuter 
utility. Such systems must run continuously and reliably 7 
days a week, 24 hours a day, in a way similar to telephone 
or power systems, and must be capabte ot meeting wide 
service demands: from multiple man-machine interaction to 
the sequential processing of absentee user jobs; from the use 
of the system with dedicated languages and subsystems to 
the programming of the system itself; and from centralized 
bulk card, tape, and printer facilities to remotely located 
terminals. Such information processing and communication 
systems are believed to be essential for the future growth of 
computer use in business, in industry, in government and in 
scientific laboratories, as well as stimulating applications 
which would otherwise be untried. 

Because the system must ultimately be comprehensive 
and able to adapt to unknown future requirements, its fr.une- 
wt)rk must be general, and capable of evolving with lime. As 
brought out in the sequel, this need for an evolutionary 
framework influences and contributes to much of the system 
design and is a major reason why most of the prograinining 
of the system has been done in a subset of the PL /I language. 
Because the PL/ 1 language is largely machine-independent 
(e.g., data descriptions refer to logical items, not physical 
words), the system should also be. Specifically, it is hoped 
that future hardware improvements will not make system 
and user programs obsolete and that implementation of the 
entire system on other suitable computers will require only 
a moderate amount of additional programming. 

As computers have matured during the last two (let ades 
from c uriositios to c ale ulating machines to information pro 
c essors, access to them by users has not improvetl, .uul, in 
the case of most large mat hines, has retrogressed Prnu i 
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pally for economic reasons, batch processing of computer 
jobs has been developed and is currently practiced by most 
large computer installations, and the concomitant isolation 
of the user from elementary cause-and-effect relationships 
has been either reluctantly endured or rationalized. For sev- 
eral years a solution has been proposed to the access prob- 
lem. This solution, usually called timesharing, is basically the 
rapid time-division multiplexing of a central processor unit 
among the jobs of several users, each online at a typewriter- 
like terminal. The rapid switching of the processor unit 
among user programs is, of course, nothing but a particular 
form of multiprogramming. 

The impetus for timesharing first arose from professional 
programmers because of their constant frustration in debug- 
ging programs at batch processing installations. Thus, the 
original goal was to timeshare computers to allow simulta- 
neous access by several persons while giving to each of them 
the illusion of having the whole machine at his disposal. This 
goal led to the development of the Compatible Timesharing 
System (CTSS) at M.l.T. Project MAC. However, at Project 
MAC it has turned out that simultaneous access to the ma- 
chine, while obviously necessary to the objective, has not 
been the major ensuing benefit. Rather, it is the availability 
at one's fingertips of facilities for editing, compiling, debug- 
ging, and running programs in one continuous interactive 
session that has had the greatest effect on programming. 
Professional programmers are encouraged to be more imagi- 
native in their work and to investigate new programming 
techniques and new problem approaches because of the 
much smaller penalty for failure. But, the most significant 
effect that CTSS has had on the M.l.T. community is seen in 
the achievements of persons for whom computers are tools 
for other objectives. The availability of CTSS not only has 
changed the way problems are attacked, but has caused 
important research to be undertaken that otherwise would 
not have been done. As a consequence, the objective of the 
current and future development of timesharing extends 
beyond the improvement of computational facilities with 
respect to traditional computer applications. Rather, it is the 
online use of computers for new purposes and in new fields 
which provides the challenge and the motivation to the sys- 
tem designer. In other words, the major goal is to provide 
suitable tools for what is currently being called machine- 
aided cognition. 

More specifically, the importance of a multiple-access 
system operated as a computer utility is that it allows a vast 
enlargement of the scope of computer-based activities, 
which can, in turn, stimulate a corresponding enrichment of 
many areas of our society. Over six years of experience 
indicates that continuous operation in a utility-like manner, 
with flexible remote access, encourages users to view the 
system as a thinking tool in their daily intellectual work. 
Mechanistically, the qualitative change from the past results 
from the drastic improvement in access time and conve- 
nience. Objectively, the change lies in the user's ability to 
control and affect interactively the course of a process 
whether it involves numerical compulation or manipulation 
of symbols. Thus, parameter studies are more intelligenlly 
guided; new problem-oriented languages and subsystems 
are developed to exploit the interactive capabiiily; m.iny 



complex analytical problems, as in magnetohydrodynamics, 
which have been too cumbersome to be tackled in the past, 
are now being successfully pursued; even more, new, itnagi- 
native approaches to basic research have been developed, 
as in the decoding of protein structures. These are examples 
taken from an academic environment; the effect of multiple- 
access systems on business and industrial organizations c an 
be equally dramatic. It is with such new applications in mind 
that the Multics system has been developed. Not thai the 
traditional uses of computers are being disregarded: rather, 
these traditional needs are viewed as a subset of the broader, 
more demanding, new requirements. 

To meet the above objectives, issues such as response 
time, convenience of manipulating data and programs, ease 
of controlling processes during execution, and, above all, 
protection of private information and isolation of indepen- 
dent processes, become of critical importance. These issues 
demand departures from traditional computer systems. 
While these departures are deemed to be desirable with 
respect to traditional computer applications, they .ue essen 
lial for rapid man-machine interaction. 



System Requirements 

In the early days of computer design, there was the ( oncepl 
of a single program on which a single processor computed 
for long periods of time with almost no intera( lion with the 
outside world. Today such a view is considered in'x omplete. 
The effective boundaries of an information prm essing sys- 
tem extend beyond the processor, beyond the c ard reader 
and printer, and even beyond the typing of input and ihe 
printing of output. In fact, they encompass the go.jls of many 
people. To better understand the effect of this broadened 
design scope, il is helpful to examine several phenomena 
characteristic of large, service-oriented computer instalki 
lions. 

First, there are incentives for any organization to hcwo the 
biggest possible computer system lhat it tan afford. Il is 
usually only on the biggest computers that there arc elabo 
rate programming systems, compilers, and features whic h 
make a computer "powerful". This results partly bee ause it 
is more difficult to prepare system programs for snuillcr com 
puters when limited by speed or memory si/e, and partly 
because large systems involve more persons and, heme, 
permit more attention to be given to system programs. 
Moreover, by combining resources in a single com[)uter 
system rather than in several, bulk economies and therc»fore 
lower computing costs can be achieved. Finally, as a prac ti- 
cal matter, considerations of floor space, managetncnl effi- 
ciency, and operating personnel provide a strong inc entive 
for centralizing computer facilities in a single large installa- 
tion. 

Second, the capacity of a contemporary computer instal- 
lation, regardless of the sector of applications it serves, must 
be capable of growing to meet continuously incrcMsing de- 
mand. A doubling of demand every two years is not uncom- 
mon. Multiple-access computers promise to accelerate this 
growth further since they allow a man-mac iiine interac lion 
rate which is faster by ai least two orders ot magnilude than 



HONnvwri.L coMPUTrn journai 89 



C-14 



other types of computing systems. Present indications are 
that multiple-access systems for only a few hundred users 
can generate a demand for computation exceeding the ca- 
pacity of the fastest existing single processor system. Since 
the speed of light, the physical sizes of computer compo- 
nents, and the speeds of memories are intrinsic limitations on 
the speed of any single processor, it is clear that systems with 
multiple processors and multiple memory units are needed 
to provide greater capacity. This is not to say that fast pro- 
cessor units are undesirable, but that extreme system com- 
plexity to enhance this single parameter among many 
appears neither wise nor economic. 

Third, computers are no longer a luxury used when and 
if available, but are primary working tools in business, gov- 
ernment, and research laboratories. The more reliable com- 
puters become, the more their availability is depended upon. 
A system structure including pools of functionally identical 
units (processors, memory modules, input/output controll- 
ers, etc.) can provide continuous service without significant 
interruption for equipment maintenance, as well as provide 
growth capability through the addition of appropriate units. 

Fourth, user programs, especially in a timesharing system, 
interact frequently with secondary storage devices and ter- 
minals. This communication traffic produces a need for mul- 
tiprogramming to avoid wasting main processor time while 
an input/output request is being completed. It is important 
to note that an individual user is ordinarily not is a position 
to do an adequate job of multiprogramming since his pro- 
gram lacks proper balance, and he probably lacks the neces- 
sary dynamic information, ingenuity, or patience. 

Finally, as noted earlier, the value of a timesharing system 
lies not only in providing, in effect, a private computer to a 
number of people simultaneously, but, above all, in the ser- 
vices that the system places at the fingertips of the users. 
Moreover, the effectiveness of a system increases as user- 
developed facilities are shared by other users. This increased 
effectiveness because of sharing is due not only to the re- 
duced demands for core and secondary memory, but also 
to the cross-fertilization of user ideas. Thus, a major goal of 
the present effort is to provide multiple access to a growing 
and potentially vast structure of shared data and shared 
program procedures. In fact, the achievement of multiple 
access to the computer processors should be viewed as but 
a necessary subgoal of this broader objective. Thus, the 
primary and secondary memories where programs reside 
play a central role in the hardware organization, and the 
presence of independent communication paths between 
memories, processors, and terminals is of critical impor- 
tance. 

From the above it can be seen that the system require- 
ments of a computer installation are not for a single program 
on a single computer, but rather for a large system of many 
components serving a community of users. Moreover, each 
user of the system asynchronously initiates jobs of arbitrary 
and indeterminate duration which subdivide into sequences 
of processor and input /output tasks. It is out of this seem- 
ingly chaotic, random environment that one arrives at a 
utility-tike view of a computing system. For instead of chaos, 
one can average over the different user requests to achieve 
high utilization of all resources. The task of mulliprogram- 



required to do this need only be organized once in a central 
supervisor program. Each user thus enjoys the benefit of 
efficiency without having to average the demands of his own 
particular program. 

With the above view of computer use, where tasks start 
and stop every few milliseconds, and where the memory 
requirements of tasks grow and shrink, it is apparent that one 
of the major jobs of the supervisor program (i.e., monitor, 
executive, etc.) is the allocation and scheduling of computer 
resources. The general strategy is clear. Each user's job is 
subdivided into tasks, usually as the job proceeds, eac h of 
which is placed in an appropriate queue (i.e., for a processor 
or an input/output controller). Processors or input /output 
controllers are, in turn, assigned new tasks as they either 
complete or are removed from old tasks. All processor's are 
treated equivalently in an anonymous pool and arc assigned 
to tasks as needed. In particular, the supervisor dot's not 
have a special processor. Further, processors can be added 
or deleted without significant change in either the user or 
system programs. Similariy, input/output controllers are di- 
rected from queues independently of any particular pro- 
cessor. Again, as with the processors, one can add or delete 
input/output capacity according to system load without sig- 
nificant reprogramming required. 



The Multics System 

The over-all design goal of the Multics system is to ( re.Ue .1 
computing system which is t.ipable of comprehensively 
meeting almost all of the [)rc»senl and near future reciuire 
ments of a large computer service installation. It is not ex 
pected that the initial system, although useful, will re.u h the 
objective; rather, the system will evolve with lime in a gen- 
eral framework which permits continual growth to nuH-t 
unknown future requirements. The use of the PI / I l.iiimnge 
will allow major system software changes to be developed 
on a schedule separate from that of hardware changes. Since 
most organizations can no longer afford to overIa[) old and 
new equipment during changes, and since software d(>velo()- 
ment is at best difficult to schedule, this relative machine- 
independence should be a major asset. 

It is expected that the Multics system will be published and 
will therefore be available for implementation on any ecjuip- 
ment with suitable characteristics. Such publication is desir- 
able for two reasons: first, the system should withstand 
public scrutiny and criticism; second, in an age of inc reasing 
complexity, there is an obligation to present and future sys 
tem designers to make the inner operating system .is luc id <is 
possible so as to reveal the basic system issues. 

An ability to share data contained within the frafnework 
of a general-purpose timesharing system is a unic]ue fe.Uure 
of Multics, and is directly applicable to administrative^ prob- 
lems, research requiring a multi-user accessible database, 
and general application of the computer to very c()in[)lic .iled 
research problems. The attention p.iid to niec hanisms to 
()rovide and control privacy is of direct interest lor sever.il 
of the same applications ,is well as, lor example, medic .il 
data. Multics can thus be a v,ilii<il)le tool which piovides 
opportunities for important new researc h in these ,ire,is. 



90 HONEYWELL COIWIPUTER JOURNAL 



I ne nardware system 

The Honeywell 645 computer system is a large-scale infor- 
mation processing system with most of the features currently 
found in such systems. If one attempted to classify systems, 
it would fall in the same general category of size as the 
Honeywell 635, the Univac 1108, and the IBM Systems 
360/65 and 67. 

The configuration at M.I.T., shown in Figure 1, currently 
contains 384 K (K = 1024) 36-bit words of core memory (1 
microsecond access to 36 bits or 1 .3 microseconds access 



to 72 bits), two central processors (330,000 instructions per 
second when running Multics), a high-performanco paging 
drum (it moves 1024 words in 2 milliseconds, 16 mil- 
liseconds average latency with a queue-driven channol con- 
troller), 78 million words of disk storage, and a Genorali/cd 
I/O Controller which handles magnetic tapes, card equif)- 
ment, and high-speed full ASCII printers, as well as ,ill tele 
communication channels. The central processor is built on 
the Honeywell 635 instruction set with augmentation to per- 
mit control of paging and segmentation hardware. 
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Overview of Multics Capabilities 



■ The virtual memory approach 



Multics offers a number of capabilities which go well beyond 
those provided by many other systems. Those which are 
most significant from the user's point of view are described 
here. Perhaps the most interesting aspect of all is that a single 
system encompasses all of these capabilities simultaneously. 

■ The ability to be a small user of Multics. 

An underlying consideration throughout the Multics de- 
sign has been that the simple user should not pay a 
noticeable extra price for a system which also accommo- 
dates the sophisticated user. For example, a student can 
be handed a limited set of tools, can do limited work 
(perhaps debugging and running small FORTRAN pro- 
grams), and expect to receive a bill for resource usage 
which is equivalent to the limited work done. If all users 
are small, then of course the number of users can be 
increased in proportion to their smallness. As an adminis- 
trative ai(f, facilities are provided so that one can restrict 
any particular user to a specific set of tools and thereby 
limit his ability to use up resources. 

■ The ability to control sharing of information. 

There are a variety of applications for a computer system 
which involve building up a base of information which 
is to be shared among several individuals. Multics pro- 
vides facilities in two directions. 

Sharing: 

Links to other users' programs and data. , 

Ability to move one's base of operation into another user's 
directory (with his permission). 

Direit access with uniform conventions to any information 
stort'cj in the system. 

Ability hr two or more users to sh.«re .) single copy of a 
f)r()gram or data in core memory. 

Control; 

Ability to specify precisely to whom, and with what access 
mode (e.g., read, write, aniJ execute permissions are sepa- 
rate and |)er-user) a piece of data or the entire contents of 
a subdirectory are available. 

Al)iliiy to revoke access at any time. 

Ability, using the Multics protection ring structure, to force 
ai cess to a database to be only via a program supplied by 
the database owner. This facility may be used to allow 
at c ess to .iggregate information, such as averages or counts, 
or spt-cified data entries, without simultaneously giving ac- 
i ess lo the (>ntire tile of raw data, w.'iic h may be c onfiden- 
lial I here are a large nunilu'r ut potential administrative 
applications ot this leaturc>, and as lar as is known, Multics 
IS the only general-pur|H>se system which provides it. 



In the opposite direction of the little user is the person 
with a difficult research problem requiring a very large 
addressable memory. The Multics storage system, with 
the aid of a high-performance paging drum, provides this 
facility in what is often called a virtual memory of an 
extent limited only by the total of secondary storage 
devices (drums, disks, etc.) attached to the system. An 
interesting property of the Multics implementation is that 
a procedure may be written to operate in a very large 
virtual memory, but core resources are used only for 
those parts of the virtual memory actually touched by the 
program on that execution, and disk and drum resources 
are used only for those parts of the memory which ac tu- 
ally contain data. Another very useful property from a 
programmer's point of view is that information stored in 
the storage system is directly accessible to his program 
by a virtual memory address. This property elirninat(^s 
the need for explic itiy [irogrammed overlays, c hain links, 
or core loads, and tilso reduc c>s the number of cxplu illy 
programmed input and output operations. The Mullic s 
storage system takes on the responsibility for s.if(>k(H'[)ing 
of all information placcxJ there by thc^ user. It tfierelore 
automatically maintains tape copies of .ill inforniation 
which has remained in the system for more than ,ui hour. 
These tapes can be used to reload any user information 
lost or damaged as a result of hardware or software 
failures, and may also be used to retrieve individual iteins 
damaged by a user's own blunder. 

Each user has an administratively set quota of sp.uc 
which limits the amount of storage he can use, although 
he may purchase as large an amount of spac e as he 
would like. Additional disk storage can be added to the 
645 computer in large quantities if nc>cessary. 

■ The option of dynamic linking. 

In constructing a f)rogram or system of progr.uns, ii is 
frequently convenic^nt to Ix'gin testing c crttUn ((Mturcs ot 
one program before lnving writlcn another piogi.im 
whic h is needed for some c ases. I )vnamic linking allows 
the c>xec ulion of the first progrcun to l)egin, .tnd a se.irc h 
for the second [)rogram is undertaken only if ,ind when 
it is actually called by the first one. I his feature also 
allows a user to freely include in his progr.uti a coinii 
tional call out to a large and sophisticated error di.jgnos- 
tic program, sc^cure in the knowlecJge that in .ill (hose 
executions of his program which do not encounter the 
c»rror, he will not pay the cost of locating, linking, <uid 
mapping the error diagnosis package into his virtual 
memory. It also allows a user who is borrowing a pro- 
gram to provide a substitute for any subroutine c .illed by 
that program when he uses it, since he h.ts c«)ntrol over 
where the system looks to find missing subroutin<'s. In 
those cases where subroutine A calls subroutine B every 
time, there is, of course, no neeci to use dynatnic linking 
(and the implied library search), and so facilities ,ue 
therefore provideci to bind A and B togelhcM |)rioi (o 
execution. 
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■ Configuration Flexibility. 

An important aspect of the Multics design is that it is 
actually difficult for a user to write a program which will 
stop working correctly if the hardware configuration is 
changed. In response to changing system-wide needs, 
the amount of core memory, the number of central pro- 
cessors, the amount and nature of secondary storage 
(disks, drums, etc.), and the type of interactive typewriter 
terminals may change with time over a range of 2 or 3 
to 1, but users do not normally need to change their 
programs to keep up with the hardware. The system itself 
adapts to changes in the number of processor or memory 
boxes dynamically, that is, while users are logged in. 
Most other configuration changes (e.g., the addition of 
disk storage units) require that the system be reinitialized, 
an operation which takes a few minutes. 

■ The human interface. 



BASIC A translator and editor subsystem for the BASIC 
language, developed at Dartmouth College. A lim- 
ited Multics service is available which restricts (he 
use^ to just this subsystem, if desired. The BASIC 
subsystem is also available to regular Multics users. 

APL A powerful and popular interpretive language devel- 
oped by Kenneth Iverson. 

LISP List Processing language, version 1 .5. Both an inter- 
preter and a compiler for this popular language for 
"artificial intelligence" problems are available. An 
interesting feature of the Multics implementation is 
the very large structure space provided by the vir- 
tual memory. 

ALM A machine language assembler for the Honeywell 
645 computer. (It is not recommended for gener.il 
use; it is slow and the language is very difficult.) 



Experience has proven that ease of use of a timesharing 
system is considerably more sensitive to human engi- 
neering than is a batch processing system. The Multics 
command language has been designed with this in mind. 
Features such as universal use of a character set with 
both upper and lower case letters in it, and allowing 
names of files to be 32 characters long, are examples of 
the little things which allow the nonspecialist to feel that 
he does not have to discover a secret in order to be an 
effective user of the system. In a similar vein, a hierar- 
chial file system provides a very useful organization and 
bookkeeping aid, so that a user need keep immediately 
at hand only those things he is working with at the mo- 
ment. Such a facility is of great assistance when attacking 
complicated or intricately structured problems. 



Languages 

Multics provides two primary user languages: FORTRAN IV 
and PL/I. The FORTRAN compiler is fairly standard. It is 
supported by the usual library of math routines and format- 
ted input /output facilities. Its primary use is for translation of 
already written programs which have been imported from 
other computer systems. 

The Multics PL /I compiler is quite interesting because it 
offers a very full selection of language facilities, over 300 
helpful error diagnostics, and the ability to get at the ad- 
vanced features of Multics, all at a reasonable cost. On a 
"seconds to translate a source language page" basis, the 
PL /I compiler currently takes about twice as long as does the 
FORTRAN compiler; on the other hand, a page of PL/I 
program can express considerably more than a page of FOR- 
TRAN program. For these reasons, as well as the anticipated 
wide .ivail.ibititv of Pl/I on other computer systems, it is the 
rccomrncnded l.>nguage tor subsystem ifnplerTH'nU'rs ,\m\ 
Kfiicr.il rrs(Mrch user*, neeclinn ,>n expre^'>!ve l.ingu.ige, 

( )tlHM l,ini;u.»gt"s .ue: 



QEDX A programmable editor which qualifies as a minor 
interpretive language. 

All of the above languages translate a source program whi( h 
has been previously placed in the storage system. Input and 
editing of source text is done with one of the av.ul.jble text 
editors, EDM or ()EDX. Although interactive, line-l)y-line 
syntax checking languages are easily implement(»d in the 
Multics environment, none are yet available. 

A source language debugging system, named DEBUCi, 
provides the ability to inspect variables and set breakpoints 
in terms of the PL/ 1 program being debugged. It also has a 
variety of features to allow inspection of all aspects of the 
Multics execution environment. 



Reliability and Performance 

An initial version of Multics began operating on a scheduknl 
daily basis for system programming use in I9(>8 Sofilember. 
It has been scheduled to run on a 24-hour-i\-day basis sine e 
1969 May I. Since that time, almost three years of opera 
tional experience has been obtained. During this tinu*, fvU- 
ability, functional capabilities, and perforinance hav(< Ihhmi 
brought to the point that, as of 1972 january 1, a two pro- 
cessor system serves 55 simultaneous users, with good in- 
teractive response. 

The full configuration of Figure 1 is used regularly, and 
should ultimately handle about 90 average PL /I program- 
mers. Both smaller and larger users are also runnablo on the 
system, in increased and reduced numbers, respectively. 

As an offering of the M.l.T. Information Processing Center, 
Multics has attracted a community of about 600 registerecf 
users, and an equal number of unregistered student users. 
These users are organized around approximately 100 
projects, thus making Multics the primary source of time- 
sharing services at M.LT. (As with all I.P.C. computer sys- 
tems, the use of Mulli< s is (harmed to ils iiscis ,il i.ilrs 
adjusU'd to return full h.irdware and running ( osis when the 
svstivn is oper.uing al about two-thirds c ap.u ilv ) 



HONEYWELL COMPUTm .iOimNAl. 93 



C-18 



A MULTICS BIBLIOGRAPHY 



Manuals that are Generally Available 

1. Multics Programmers' Manual. An updateable refer- 
ence manual giving calling sequences and reference 
information for all user-callable subroutines and com- 
mands. Includes an introduction to the Multics pro- 
gramming environment and a guide to typical ways of 
using the system. Approximately 800 pages. 

2. The Multics System: An Examination of Its Structure, 
by E. I. Organick. A hard cover book describing in some 
detail how Multics works. The description is from the 
point of view of a programmer developing a large pro- 
gram or subsystem, who wishes to gain the extra insight 
to help him intelligently choose among available alter- 
natives of his implementation. M.I J. Press, Cambridge, 
MA, and London, England. 392 pp. (1972). 

3 . A User 's Guide to the Multics FOR TRA N Implementa- 
tion, by R.A. Freiburghouse. A document which pro- 
vides the prospective Multics FORTRAN user with 
sufficient information to enable him to create and exe- 
cute FORTRAN programs on Multics. It contains a com- 
plete definition of the Multics FORTRAN language as 
well as a description of the FORTRAN command and 
error messages. It also describes how to communicate 
with non-FORTRAN programs, and discusses some of 
the fundamental characteristics of Multics which affect 
the FORTRAN user. 68 pages. 

4. Multics PL/I Language Specification. A reference man- 
u.il which specifies precisely the subset of the PL/ 1 lan- 
guage used on Multics. 1 74 pages. 

5. tJ.<ier\ Guide to the Multics PL/I Implementation, by 
R.A Freiburghouse, et al. Provides detailed information 
about how the PL/ 1 language is embedded in the Mul- 
tics programming environment. 53 pages. 

6. Graphic Users' Supplement to the Multics Program- 
mers' Manual In the same format as the Multics Pro- 
grammers' Manual, this supplement gathers in one 
|)late (lest riplions of the Multiis Ciraphiis System and 
Iht' commands and subroutines needed to use it. Ap- 
proximatfly 5S pages, illustrated. 



Manuals that may be examined in the 
Project MAC or I. P. C. Document Rooms 

T. Multics System Programmers' Manuaf In f)rin( iple, a 
complete rt^ferenc e manual describing how th(> sysU>m 
works inside. In fact, this doc ument contains m.uiy sec - 
tions which are inconsistent, inaccurate, or ()l)solete; it 
is in need of much upgrading. However, its overview 
sections are generally accurate and valual)U> if insight 
into the internal organization is desired. Approximately 
3,500 pages. 

2. System Programmers' Supplement to the Multics Pro- 
grammers' Manual. This updateable reference manual, 
in the same format as the Multics Programmers' Man- 
ua^l, provides caHing seqtiefH.es of every system 
module. Approximately 850 pages. 

3. EPLBSA Programmer's Reference Handbook, by 
D.j.Riesenberg. A manual cJescribing the assembly (ma- 
chine) language for the Honeywell 645 computer. The 
language has been renamed ALM since* the public ation 
of this manual. (Nec^dt^d only by progr.uiiniers with 
some special reason to use 645 mac hine langu.ige.) 85 
pages. 

4. Honeywell 645 Processor Manual. A h.uclvvare de- 
scription, including o[K:odes, .iddrt^ssing modifiers, e\c. 
Of interest only to dedicated mac hine language pro- 
grammers. 175 pages. 

5. Subsystem Writers' Supplement to the Multiis Pro- 
grammers' Manual. A manual giving c ailing s<M|u<'nc es 
of internal interface's of the system whic h arc user- 
accessible. For the s()|)histic ated subsystem wriler who 
feels thai ii is important io bypass some standard Mul- 
tics facility, this manual provides some help in using 
interfaces one level deeper into the system. This manual 
is definitely not for the casual user. Approximately 50 
pages. 
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Technical Papers about Multics 

1 . F.J.Corbat6 and V.A.Vyssotsky, "Introduction and Overview 
of the Multics System", AFIPS Conf. Proc., Fallloint Comput. 
Conf. 27, Spartan Books, Washington, OC, 1965, pp. 185- 
196. 

2. E.L.GIaser, et al., "System Design of a Computer for Timeshar- 
ing Application", AFIPS Conf. Proc., Fallloint Comput. Conf. 
27, Spartan Books, Washington, DC, 1965, pp. 197-202. 

3. V.A.Vyssotski, et al., "Structure of the Multics Supervisor", 
AFIPS Conf. Proc., Fall /oint Comput. Conf. 27, Spartan 
Books, Washington, DC, 1965, 203-212. 

4. R.C.Daley and P.G.Newmann, "A General-Purpose File Sys- 
tem for Secondary Storage", AFIPS Conf Proc., Fall loint 
Comput. Conf 27, Spartan Books, Washington, OC, 1965, 
pp. 213-229. 

5. l.F.Ossanna, et al., "Communication and Input/Output 
Switching in a Multiplex Computing System", AFIPS Conf. 
Proc., Fall loint Comput. Conf. 27, Spartan Books, Washing- 
ton, DC, 1965, pp. 231-241. 

6. E.E.David, Jr. and R.M.Fano, "Some Thoughts About the Social 
Implications of Accessible Computing", AFIPS Conf Proc., 
Fallloint Comput. Conf 27, Spartan Books, Washington, OC, 
1965, pp. 243-247. 

7. A.Bensoussan, C.T.CIingen and R.C.Oaley, "The Multics Vir- 
tual Memory", A CM Second Symp. on Operating Syst. Princi- 
ples. Princeton University, 30-42 (1969). 

8. C.T.CIingen, "Pr<^ram Naming Problems in a Shared Tree- 
Structured Hierarchy", NATOSci. Committee Conf on Tech- 
niques in Software Engg. 1, Rome, Italy (1969). 

9. R.M.Graham, "Protection in an Information Processing Util- 
ity", Commun. ACM 11, No. 5, 306-312 (1968). 

1 0. F.j.Corbato and j.H.Saltzer, "Some Considerations of Supervi- 
sor Program Design for Multiplexed Computer Systems", IFIP 
Conf Proc., Invited Papers, 66-72 (1968). 

1 1 . R.C.Daley and J.B.Oennis, "Virtual Memory, Processors, and 
Sharing in MULTICS", Commun. ACM 11, No. 5, 365-369 

(1968) . 

12. F.J.Corbatd, 'PL/I as a Tool for System Programming", Data- 
mation 15, No. 6, 68-76 (1969). 

1 3. F.J.Corbat6, "A Paging Experiment with the Multics System", 
In Honor of PM. Morse, M.l.T. Pr., Cambridge, MA, 21 7-228 

(1969) . 

1 4. J.H.Saltzer and J.W.Gintell, "The Instrumentation of Multics", 
ACM Second Symp. on Operating Syst. Principles. Princeton 
University, 167-174 (1%9). also in Commun. ACM 13, No. 
8,495-500(1970). 

15. M.J.Spier and E.t.Organick, "The Multics Inter-Process Com- 
munication Facility", ACM Second Symp. on Operating Syst. 
Principles, Princeton University, 83-91 (1969). 

16. R.A.Freiburghouse. "The Multics PL/I Compiler", AFIPS Conf 
Proc. 35, AFIPS Pr., 187-199 (1969). 



17. J.M.Grochow, "Real-Time Graphic Display of Timesharing 
System Operating Characteristics", AFIPS Conf Proc, Fall 
loint Comput. Conf 35, AFIPS Pr.. 379-385 (1969). 

18. J.H.Saltzer and j.F.Ossanna, "Remote Terminal Character 
Stream Processing in Multics", AFIPS Conf Proc, Spring loint 
Comput. Conf 36, AFIPS Pr., 621-627 (1970). 

19. J.F.Ossanna and J.H.Saltzer, "Technical and Human Engineer- 
ing Problems in Connecting Terminals to a Timesharing Sys- 
tem", AFIPS Conf Proc., Fallloint Comput. Conf 37, AFIPS 
Pr., 355-362 (1970). 

20. D.D.Clark, R.M.Graham, j.H.Saltzer and M.D.Schroeder, 
"Classroom Information and Computing Service", M.l.T. 
Project MAC Technical Report TR-80, (1971). 

21. M.D.Schroeder, "Performance of the GE-645 Associative 
Memory While Multics is in Operation", ACM Workshop on 
Syst. Performance Evaluation, 227-245 (1971). 

22. M.D.Schroeder and J.H.Saltzer, "A Hardware Arthinn^^turo for 
Implementing Protection Rings", ACM Third Symp. on OfH'r- 
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23. R.J.Reiertag and E.I.Organick, "The Multics Input/Output Sys- 
tem", ACM Third Symp. on Operating Syst. Principles, Palo 
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M.l.T. Theses related to Multics 

1. J.H.Saltzer, "Traffic Control in a Multiplexed Computer Sys- 
tem", Sc.D., MAC-TR-30, (1966). 

2. R.Rappaporl, "Implementing Multi-Process Primitives in ,i 
Multiplexed Computer System", S.M., MAC-TR-55, (19(>8). 

3. H.Deitel, "Absentee Computations in a Muhiple-A(.xos> Com- 
puter System", S.M., MAC-TR-52, (1968). 

4. J.Greenbaum, "A Simulator of Multiple Inlrractivo Users to 
Drive a Timeshared Computer System", S.M., MAC -TK-Sfl, 
(1968). 

5. I.M.Crochow, "The Graphic Display as an Aid in the Monitor- 
ing of a Timeshared Computer System", S.M., MAC-rR-54, 
(1968). 

6. R.I.Ancona, "A Compiler for MAD-Based Language on Mul- 
tics", S.M., (1968). 

7. D.Clark, "A Reduction Analysis System for Parsing PL /I", 
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8. M.D.Schroeder, "Classroom Model of an Information and 
Computing Service", S.M., (1969). 

9. C.M.Vogt, "Susj)ensi()n of Processes' in a MultipriK ossitig 
Computer System", S.M., (1970). 

10. R.Frankston, "A Limited Service System on Miiliits", S.H., 
(1970). 

1 1 . R.R.Sthell, "Dynamic Reconfiguration in a M(Kkilar CompuitM 
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ny y X O u ±\J H OUUoyduCIll ll VJ(^I CIUIUiXIl{^ 






Teohn i nue s 


F19 


2-Days 


Advanced Proffi^am Dehuffffincr Teohninues 


Data Base 






F32 


3-Days 


LINUS Utilization 


F31 


5-Days 


MRDS Utilization 


F30 


2-Days 


MRPG Utilization 


Word Processing 




*F41 


1-Day 


WORDPRO Basic Utilization 


»F42 


3-Days 


WORDPRO Advanced Utilization 


F43 


5-Days 


WORDPRO for Document Administrators 


Administration and Operation 




F60 


5-Days 


tJjSfv^lU AVi lU X 11 X O V t eivXvil 


F617 


6-8 Hour VAL 


Project Administration 


F68 


5-Days 


Operator Training 


Applications 




+F70 


5-Days 


Graphics Programming 


Operating 


Supervisor 


• 


F80 


5-Days 


Multics Process Management Analysis. 


+F81 


5-Days 


Multics Failure Analysis and Recovery 


+F86 


5-Days 


MCS Concepts and Implementation 



Miscellaneous 

+F90 3-Days 



GCOS Environment Simulator 
Utilization 



Not currently available (December, 78) 
Conducted on-site by special request only 
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FOI 



LANGUAGES 



RECOMMENDED 



COURSE SELECTION GUIDE 

SUPPLEMENTAL/OPTIONAL 



MULTICS CONCEPTS AND UTILIZATION 
FOl I CLAS SROOM I 5-DAYS 




PL/ I CONCEPTS 



G15 I 



CLASSROOM 

i 



I 2~DAYS 



COMMERCIAL PL/I PROGRAMMING 



F15A| CLASSROOM | 3-DAYS" 



SCIENTIFIC PL/ I PROGRAMMING 



F15B 



CLASSROOM 



3-DAYS 



AJDVANCED PROGRAM DEBUGGING TECH. 



F19 



CLASSROOM 



2-DAYS 



I 



ADVANCED PL/ I PROGRAMMING 



F15C 



CLASSROOM 



3-DAYS 



APPLICATION SUBSYSTEM PROG. 



F15D 



CLASSROOM 



5-DAYS 



COBOL PROGRAMMING 



G434 



SI 



30-36 HRS 



COBOL- 74 PROGRAMMING SPECIFICS 
F13 i CLASSROOM | 5-DAYS" 



ADVANCED PROGRAM DEBUGGING TECH. 
FI9 I CLASSROOM I a-DAYS 




G047 



FORTRAN IV LANGUAGE 

VAL I 30-34 HRS 



FORTRAN SPECIFICS 



F14 } 



CLASSROOM 



3-DAYS 



FUNDAMENTALS OF EDP 



G014 I 



SI 



6-8 HRS 



PROGRAMMING LOGIC & FLOWCHARTING 



G024 



SI 



136-44 HRS 



DECISION TABLES 



G527 I 



VAL 



i 12-16 HRS 



MULTICS FEATURES, 

FUNCTIONS & BENEFITS 



F027 



VAL 



I 6-8 HRS 



COBOL CONCEPTS 



G334 



SI 



12-15 HRS 



(basic) 



BASIC 


(PROGRAMMING LANGUAGE) 


G537 1 


VAL 112-16 HRS 


i 


BASIC SPECIFICS 


F127 


VAL j 12-16 HRS 




APL (PROGRAMMING LANGU AClQ 
"gU I CLASSROOM T 3-1)aYs 



I 



APL SPECIFICS 



Fll 



CLASSROOM 



2-DAYS 



D-2 



DATA BASE 



COURSE SELECTION GUIDE 



RECOMMENDED 



SUPPLEMENTAL /OPT TONAL 



MULTICS CONCEPTS & UTILIZATION 



FOl 



CLASSROOM 



5-DAYS 




LINUS & REPORT GEN. UTILIZATION 
F32 I CLASSROOM I 5-DAYS 



FUNDAMENTALS OF 


EDP 




G014 CLASSROOM 


6-8 


jms_ 








MULTICS FEATURES, 

FUNCTIONS & BENEFITS 


F027 1 VAL 


|6-8 


HRS 



COMMERCIAL PL /I PROGRAMMING 



F15A 



CLASSROOM 



3- DAYS 



COBOL- 74 SPECIFICS 



F13 I CLASSROOM | 5-DAYS 



MRDS UTILIZATION WITHIN 
APPLIC. PROG. 



F31 



CLASSROOM 



5-DAYS 



DATA BASE CONCEPTS 



G078 



IBR 



1-HR 



ADMINISTRATION AND OPERATION 
COURSE SELECTION GUIDE 



RECOMMENDED 



[ADMINISTRATIOl 





MULTICS CONCEPTS & UTILIZATION 




FOl 1 CLASSROOM 1 5-DAYS 












PROJECT ADMINISTRATION 




F617I VAL 14-6 HRS 







1 



SYSTEM ADMINISTRATION 
F60 I CLASSROOM I 5-DAYS 




SUPPLEMENTAL/OPTIONAL 



FUNDAMENTALS OF EDP 


G014 1 SI |6-8 


HRS 




MULTICS FEATURES, 




FUNCTIONS & BENEFITS 




F027 1 VAL 16-8 


HRS 



OPERATOR TRAINING 



CLASSROOM \ S-DAYS" 



F68 



D-4 



OPERATING SUPERVISOR 
COURSE SELECTION GUIDE 



RECOMMENDED 



SUPPLEMENTAL/OPTIONAL 



MULTICS CONCEPTS & 


UTILIZATION 


FOl 1 CLASSROOM 


5-DAYS 







G15 



PL/ I CONCEPTS 



CLASSROOM 



2-DAYS 



COMMERCIAL PL/ 1 PROGRAMMING 



F15A| 



CLASSROOM 



I 



3-DAYS 



SCIENTIFIC PL/ I PROGRAMMING 



F15B 



CLASSROOM 



I 



3-DAYS 



ADVANCED PROGRAM DEBUGGING TECH. 



F19 



CLASSROOM 



2-DAYS 



G014 



FPUDAMENTALS OF EDP 



SI 



6-8 HRS 



PROGRAMMING 


LOGIC & 


FLOWCHARTING 


G024 


SI 


136-44 HRS 





DECISION 


TABLES 


G527I 


VAL 


112-16 HRS 



MULTICS FEATURES, 

FUNCTIONS & BENEFITS 



F027 



VAL 



6-8 HRS 



ADVANCED PL /I PROG. TECHNIQUES 
F15C| CLASSROOM I 3-DAYS 



APPL ICA TION SUBSYSTEM PROG. TECH. 

CLASSROOM I 5-DAYS" 



F15D 



SYSTEM ADMINISTRA TION 
F60 i CLASSROOM 



I 



5-DAYS 



MULTICS PROCESS MGMT. ANALYSIS 



F80 



CLASSROOM 



5-DAYS 



OPERATOR TRAINING 



F68 



CLASSROOM 



5-DAYS 



MULTICS FAILURE ANALYSIS & RECOV. 



F81 



CLASSROOM 



5-DAYS 



COMMUNICATIONS 
COURSE SELECTION GUIDE 



RECOMMENDED 



MuLTlCS CONCEPTS & UTILIZATION 



FOl 



CLASSROOM 



I 



5-DAYS 



COMMUNICATION CONCEPTS 



G60 



CLASSROOM 



2-DAYS 



I 



MCS CONCEPTS & IMPLEMENTATION 



F86 



CLASSROOM 



5-DAYS 



SUPPLEMENTAL/OPTIONAL 



FUNDAMENTALS OF EDP 



I 6-8 HRS 



G014 



SI 



COMMUNICATIONS CONCEPTS (BASIC) 
G064 I SI i 6-8 HRs' 



COMM. SYS. ANALYSIS & DESIGN 



086 



CLASSROOM 5-DAYS 



THE DISTRIBUTED ENVIRONMENT 
G80 I CLASSROOM | 2-DAY s" 



MULTICS FEATURES, FUNCTIONS, 
& BENEFITS 
F027 I VAL I 6-8 HR S 



D-6 



APPLICATIONS AND MISCELLANEOUS 
COURSE SELECTION GUIDE 



RECOMMENDED 



SUPPLEMENTAL/OPTIONAL 





MULTICS CONCEPTS 


& UTILIZATION 1 


FOl CLASSROOM | 5-DAYS 











:graphics 



MULTICS FEATURES, 

FUNCTIONS & BENEFITS 



F027 



VAL 



6-8 HRS 




GRAPHICS PROGRAMMING 



F70 



CLASSROOM 



3-DAYS 




GCOS ENVIRONMENT SIMULATOR UTIL. 



F90 



CLASSROOM 



3-DAYS 
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COMMANDS/MANUALS CROSS REFERENCE 



AG92/r2 029and963 

AG92/r2 MAP 

AR97/aA TEST (BOS) 

AR97/aA TSTCHN (BOS) 

AK92/aB aa 

AG92/r2 ab 

AG92/r2 abbrev 

AZ03/rO abbrev_ 

AZ03/rO abbrev_$abbrev_ 

AZ03/rO abbrev_$expanded_line 

AZ03/rO abbrev_$set_cp_ 

AG92/r2 abc ^ 

AG93/aD absolute_pathname_ 

AG92/r2 ac 

AG92/r2 accept__messages 

AN52/rO acm 

AK92/aB active_f nc_err_ 

AS68/rO add_anon 

AG92/r2 add_name 

AG92/r2 add_search_rules 

AG92/r2 ad just_bit_count 

AG93/aD ad just_bit_count_ 

AK50/rO adinin_util 

AK92/aB aim_check_ 

AK92/aB aim_check_$equal 

AK92/aB aira_check_$gr eater 

AK92/aB aim_check_$ 

greater_or_equal 

AN52/rO alarm_clock_meters 

AK92/aB aim 

AK92/aB alm_abs 

AG92/r2 alv 

AG92/r2 am 

AG92/r2 an 

AG92/r2 and (AF) 

AG92/r2 ans 

AG92/r2 answer 

AG92/r2 apl 

AG92/r2 ar 

AG92/r2 archive 

AK92/aB archive_sort 

AK92/aB area_info_ 

AK92/aB area_status 

AK92/aB as 

AK51/r1 as_who 

AK92/aB ascii_to_ebcdic_ 

AK92/aB ascii_to_ebcdic_$table 

AZ03/rO ask_ 

AZ03/rO ask $ask 



AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AG92/r2 
AK92/aB 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AS68/rO 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AS68/rO 
AS68/rO 
AS&8/rO 
AG92/r2 
AG92/r2 
AZ03/rO 
AN52/rO 
AG92/r2 
AG93/aD 
AS68/rO 
AK50/rO 
AS68/rO 
AK50/rO 
AG92/r2 



ask_$ask_c 

ask_$ask_cf lo 

ask_$ask_cint 

ask_$ask_cline 

ask_$ask_clr 

ask_$ask_f lo 

ask_$ask_int 

ask_$ask_line 

ask_$ask_n 

ask_$ask_nf lo 

ask_$ask_nint 

ask_$ask_nllne 

ask_$ask_prompt 

ask_$ask_setline 

asr 

assign_ 

assign_resource 

attach_lv 

basic 

bd 

bill 
bind 

branches (AF) 
calc 

cancel__abs_request 

cancel_cobol_program 

cancel_daeraon_request 

car 

ccp 

cd 

cdr 

cdwd 

ceil (AF) 

cem 

cf 

chaddr 

chalias 

change 

ph^incip H^arnnl \- i-rH i r 

Chang e_error_mode 

change_kst_attributes 

change_tuning_p«'jrameter s 

change_wdir 

change_wdir_ 

charge 

charge_disk 

chdf_pro j 

check_dir 

check iacl 
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COMMANDS/MANUALS CROSS-REFERENCE 



AG92/r2 check_inf o_segs 

AS68/rO check_log 

AZ03/rO check_mdcs 

kK'jO/rO check_mst 

AZOi/rO check_mst 

AN53/rO check_sst 

AK92/aB check_star_naine_ 

AK92/aB check__star_naine_$entr y 

AK92/aB check_star_name_$path 

AS68/rO chname 

AS68/rO chpass 

AS68/rO chprog 

AG92/r2 cis 

AZ03/rO cka 

AK50/rO ckm 

AZ03/rO ckm 

AK50/rO clean_card_pool 

AK50/rO clear_projf ile 

AK50/rO clear reqfile 

AG93/aD clock" 

AG92/r2 close_file 

AG92/r2 co 

AK50/rO cob 

AZ03/rO cob 

AG92/r2 cobol 

AG93/aD com_err_ 

AG93/aD com_err_ 

AG93/aD com_err_$suppress_name 

AG93/aD command_quer y_ 

AK'30/rO comp_dir_info 

AZ03/rO comp_dir_info 

AG92/r2 compare 

AG92/r2 compare_asci i 

AK50/rO compare_mst 

AZ03/rO compare_mst 

AK50/rO compare_ob ject 

AZ03/rO compare__ob ject 

AKt)0/rO compute_bill 

AK92/aB condition_interpreter_ 

AG92/r2 console_output 

AK92/aB cont inue_to_signal_ 

AK92/aB convert_aim_attr ibutes_ 

AG93/aD convert_authori2ation_ 

AG93/aD convert_author i zation_$ 
decode 

AG9j/aD convert_authori zation_$ 
encode 

AG93/aD convert_author ization_$ 
from string 



AG93/aD convert_author izat ion_$ 
minimum 

AG93/aD con vert_author izat ion_$ 

to_string 

AG93/aD convert_authori zat ion_$ 

to_string_short 

AG93/aD con ver t_date_to binary 

AG93/aD convert^date~"to~binar y' $ 

relative 

AK92/aB convert_dial message 

AK92/aB convert_status code 

AG92/r2 copy 

AG92/r2 copy_acl 

AK50/rO copy_as_meters 

AG92/r2 copy_cards 

4N53/rO copy_dump 

AN53/rO copy_dump$set_fdump num 

AN53/rO copy_dump$sfdn 

AN53/rO copy_dump_seg _ 

AG92/r2 copy_file 

AG92/r2 copy_iacl_dir 

AG92/r2 copy_iacl_seg 

AZ03/rO copy_mst 

AK92/aB copy_names 

AN53/rO copy_out 

AK50/rO copy_pnt 

AN53/rO copy_salvager output 

AG92/r2 cp 

AG92/r2 cpa 

AG92/r2 cpf 

AZ03/rO cpm 

AG92/r2 cpt 

AG93/aD cpu_time_and_paging 

/^G92/r2 cr 

AG92/r2 create 

AK92/aB create_area 

AK50/rO create_cmf 

AK50/rO create_daemon_queues 

AG92/r2 create_dir 

AZ03/rO create_ips_mask_ 

AS68/rO credit 

AK50/rO cref. 

AZ03/rO cref 

AK50/rO cross_ref er ence 

AZ03/rO cross_ref erence 

AN52/rO ctp 

AS68/rO cu 

AG93/aD cu 



E~2 
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AK92/aB GU_ 

AK92/aB cu_$af_arg_count 

AK92/aB cu_$af_arg_ptr 

AK92/aB cu_$af_return_arg 

AG93/aD cu_$arg_count 

AK92/aB cu_$arg_list_ptr 

AG93/aD cu_$arg_ptr 

AK92/aB cu_$arg_ptr_rel 

AK92/aB cu_$cl 

AG93/aD cu_$cp 

AK92/aB cu_$decode_entr y_value 

AK92/aB cu_$generate_call 

AK92/aB cu_$get_cl_interined iar y 

AK92/aB cu_$ 

get_coramand_processor 

AK92/aB cu_$get_ready_mode 

AK92/aB cu_$get_read y_procedure 

AK92/aB cu_$level_get 

AK92/aB cu_$level_set 

AK92/aB cu_$ready_proc 

A K 9 2 / a B c u_$ s e t_c 1_ i n t e r m e d i a r y 

AK92/aB cu_$ 

set_command_processor 

AK92/aB cu_$set_ready_mode 

AK92/aB cu_$ set_ready_procedur e 

AK92/aB cu_$staGk_frame_ptr 

AK92/aB cu_$stack_frame_size 

AG92/r2 cumulati ve_page_trace 

AK92/aB cv_bin_ 

AK92/aB cv_bin_$dec 

AK92/aB cv_bin_$oct 

AK50/rO cv_cmf 

AK92/aB cv_entry_ 

AK92/aB cv_hex_ 

AK92/aB cv_oct_ 

AK92/aB cv_oct_check 

AK51/r1 cv_pmf 

AK92/aB cv_ptr_ 

AG92/r2 cwd 

AG92/r2 d 

AG92/r2 eta 

AK50/rO daily_log_process 

AK'30/rO dail y_su[nmar y 

AK^jO/rO dail y_syser r_process 

AR9Y/aA daily_syserr_process 

AG92/r2 date (AF) 

AZ03/rO date_deleter 

AG92/r2 date_time (AF) 

AG93/aD date time 



AG93/aD date_time_$fstime 

AZ03/rO datebin_ 

AZ03/rO datebin_$clockathr 

AZ03/rO datebin_$datebin 

AZ03/rO datebin_$datofirst 

AZ03/rO datebin_$dayr_clk 

AZ03/rO datebin_$dayr_mc 

AZ03/rO datebin_$ 

following_mid night 

AZ03/rO datebin_$last_midnight 

AZ03/rO datebin_$ 

next_shif t_change 

AZ03/rO datebin_$ 

preced ing_mid night 

AZ03/rO datebin_$revert 

AZ03/rO datebin_$revertabs 

AZ03/rO datebin_$shift 

AZ03/rO datebin_$this_midnight 

AZ03/rO datebin_$time 

AZ03/rO datebin_$wkday 

AS68/rO day 

AG92/r2 day (AF) 

AG92/r2 day_name (AF) 

AG92/r2 db 

AK92/aB den 

AG92/r2 dcr 

AG92/r2 dd 

AZ03/rO deactivate_seg 

AG92/r2 debug 

AG92/r2 decode 

AG93/aD decode_clock_val ue_ 

AZ03/rO decode_def init ion_~ 

AZ03/rO decode_def inition $full 

AZ03/rO decode_def inition $ i nit 

/iK92/aB decode_descriptor 

AG92/r2 default (AF) 

AG92/r2 def er_messages 

AK92/aB define_area 

AS68/rO delegate 

AG92/r2 delete 

AG93/aD delete_ 

AG93/aD delete_$path 

AG93/aD delete $ptr 

AG92/r2 delete"acl 

AG92/r2 delete_dir 

AK92/aB delete_ex terna 1_ 

variables 

AG92/r2 delete_force 

AG92/r2 delete iacl dir 
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AG92/r2 delete_iacl_seg AR97/aA 

AG92/r2 delete_message AN53/rO 

AG92/r2 delete__name AG92/r2 

AK^O/rO delete_proj AN52/rO 

AG92/r2 delete_search_rules AG92/r2 

AG92/r2 detach_lv AG92/r2 

AN52/rO dev ice_nieters AK92/aB 

AR97/aA device_meters AK92/aB 

AG92/r2 df AG92/r2 

AG92/r2 dial AK50/rO 

AK92/aB dial_manager__ AK50/rO 

AG92/r2 did AK50/rO 

AG92/r2 directories (AF) AS68/rO 

AG92/r2 directory (AF) AK50/rO 

AG92/r2 dirs (AF) AG92/r2 

AG92/r2 dis AK50/rO 

AG93/aD discard_ AG92/r2 

AN52/rO disk__queue AG93/aD 

AS68/rO disk_report AG92/r2 

AK50/rO disk_stat_print AG92/r2 

AK51/rl disk_stat__print AG92/r2 

AK50/rO disk__usage_stat AG92/r2 

AK50/rO disklow AG92/r2 

AZ03/rO display_branch AG92/r2 

AG92/r2 display_cobol_run_unit AK50/rO 

AK92/aB d ispl ay_cotnponent_name AG92/r2 

AZ03/rO display_kst__entry AG92/r2 

AG92/r2 display_pl 1 io__err AK50/rO 

AG92/r2 divide (AF) /^K92/aB 

AG92/r2 dl AR97/aA 

AG92/r2 dlv AK92/aB 

AG92/r2 dm AZ03/rO 

AS68/rO dmisc - AG92/r2 

AG92/r2 dn kG92/r2 

AG92/r2 do AZ03/rO 

AG92/r2 dp AG93/aD 

AG92/r2 dpe AG93/aD 

AS68/rO dpmf AN53/rO 

AG92/r2 dpn AG92/r2 

AG92/r2 dprint AG92/r2 

AK92/aB dprint__ AG92/r2 

AS68/rO dproj AG92/r2 

AG92/r2 dpunch AN52/rO 

AN'j2/rO dq AG92/r2 

AG92/r2 ds AK92/aB 

AK50/rO dsp AZ03/rO 

AG92/r2 dsr AZ03/rO 

AK50/rO dump_cdt 

AR97/aA dump_f irmware AZ03/rO 
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dump_mpc 

dump_pdmap 

dump_segment 

dvm 

e 

ear 

ebcdic to ascii 
ebcdic~to~asci i~$ table 
ec 

ed_installation parms 
ed_mgt 
edit_pro j 
edit_pro j 

edit_pro j$change_all 

edm 

edur f 

encode 

encode_clock_value_ 

enm (AF) 

enter 

enter_abs_request 

enterp 

entry (AF) 

ep 

epro 

equal (AF) 
equal_name (AF) 
erf 

error_table_cornpi ler 

et 
etc 

excer pt_mst 

exec_com 
exists (AF) 
expand 

expand_path_ 

expand_pathname_ 

extract 

fa 

fast 
fcs 

f i le_output 

f ile_system_meter s 

files (AF) 

f ind_cond 1 1 ion_in f o 

f ind_include_f i le 

find_include_filo $ 

g e t_se a r c h_r u 1 e s 
f ind_include__f i le_$ 

initiate count 
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AZ03/rO find_include_file_$ 

set_search_rule;s 

AG92/r2 fl (AF) 

AG92/r2 floor (AF) 

AN52/rO flush 

AG92/r2 fo 

AN53/rO format_355_dump__line_ 

AN53/rO forraat_355_dump__line_$ 
line 

AG92/r2 f ormat_cobol_source 

AG92/r2 format_line (AF) 

AG92/r2 fortran 

AG92/r2 fortran_abs 

AG92/r2 fs_chname 

AN52/rO fsm 

AG92/r2 ft 

AG92/r2 gc 

AG92/r2 gel 

AG92/r2 gcos 

AG92/r2 general_ready 

AK50/rO generate_mst 

AZ03/rO generate_mst 

AN53/rO get_ast_name_ 

AG93/aD get_author i zation_ 

AZ03/rO get_bound_seg_info_ 

AG92/r2 get_com_line 

AK92/aB get_def ault_wdir_ 

AK92/aB get_def inition_ 

AK51/r1 get_dir_quota 

AN53/rO get_dump_ptrs_ 

AK92/aB get_entr y_name_ 

AK92/aB get_equal_name_ 

AG93/aD get_group_id_ 

AG93/aD get_group_id_$ tag_star 

AZOj/rO get_initial__ring_ 

AZ03/rO get_librar y_segment 

AG93/aD get_line_leng th_ 

AG93/aD get_max_author ization_ 

AG92/r2 get_pathnaine (AF) 

AG93/aD get_pdir_ 

AK92/aB get_pr i v ileges_ 

AG9j/aD get_process_id_ 

AG92/r2 get_quota 

AK92/aB get_ring_ 

AK92/aB get_sy stem_f ree_ar ea_ 

AG92/r2 get_sy stem_search_rules 

AG93/aD get_temp_segments_ 
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SECTION I 



INTRODUCTION 



The purpose of this document is to aid the user in understanding 
errors that may occur during use of Multics. The standard Multics 
error reporting mechanism is introduced, and the meaning of error 
messages is explained. Possible causes of many errors are discussed, 
and when applicable, methods for recovering from, or circumventing an 
error are presented. 



HOW TO READ THIS DOCUMENT 

This document is intended for use by novice users or applications 
programmers unfamiliar with the Multics programming environment. As a 
result, the kinds of errors covered and the examples given have been 
tailored to this audience. 

The discussion of error conditions is divided into four sections. The 
first explains command processor errors. This includes all errors 
that arise in the interpretation of commands, and the formation of 
command names and command arguments. The second section, entitled 
"Command Errors", deals with errors that are detected by commands 
themselves. For example, an editor will report an error when a 
request is issued to read a nonexistant file. The third section 
discusses execution errors: hardware (simulated) conditions that 
arise during the execution of programs. Examples of this class of 
errors include zero divide, subscript range, and segment fault. Such 
errors may occur in user or system programs and generally indicate the 
presence of a program bug. As a result, this section is of the 
greatest use to programmers creating and debugging a new program. The 
fourth section covers fatal process errors. These are similar in 
origin to execution errors, but cause the user's process to be 
aborted. Language-specific errors such as input/output, BASIC run 
time errors, etc. are not covered by this memo. 

Each section describes the most commonly occurring errors of the 
particular class. Console scripts, along with descriptive 
commentaries, are used to present typical examples of the error, the 
methods used to determine the actual cause of the error, and means for 
recovering from the error. The memo is partially tutorial; however, 



1-1 



for complex explanations, the user will be referred to the MPM. 

This document may be used as a reference for individual errors. 
However, it is felt that the reader would benefit by at least one 
reading from cover to cover. This should provide experience with 
errors that otherwise could only only be obtained by a long period of 
actual use. Furthermore, many errors have related causes and 
consequently related methods for analysis, and since, in general, a 
topic is explained in full detail only once, a thorough reading will 
help the user see how «a specific technique or error falls into the 
overall scheme. Finally, the reader should find a number of 
worthwhile hints that enable him or her to avoid problems in the first 
place . 

User feedback is solicited concerning errors in this document, awkward 
or incomprehensible explanations, common problems that have been left 
out, etc. 



THE PROGRAMMING ENVIRONMENT 

To obtain a good understanding of errors and their causes, it is 
helpful to understand the environment in which programs run. (Often, 
too, it is simply a misunderstanding that is the cause of the error.) 
Below is a brief and simplified discussion of the basic features and 
terminology of the Multics programming environment. Refer to the MPM 
Reference Guide (Order No. AG91) for more detailed information. 

A process is a computation or execution activity much like a job on 
other computer systems. The term refers, collectively, to the program 
or group of programs in execution, the current value of program 
variables, the address space (the temporary and permanent segments of 
memory that have been referenced), the files and other input/output 
devices (e.g., console, tape volumes) in use, and various 
system-maintained data bases. What is important to the programmer is 
the duration of the process, since it maintains the programming 
environment. When the user first logs in (1) a new process is 
created. At this time, all per process information is put into a 
consistent initial state. There are no files or devices attached 
besides the terminal; all program variables are (in effect) set to 
their initial values; and so forth. A process is terminated when the 
user logs out, gives the new_proc command, or a fatal error occurs. 

On Multics, programs and their data reside in a virtual memory or 
address space . This consists of (potentially) a large number of 
disjoint se gments of storage. Each such segment may contain up to 
255K (K = 102^) words of storage, and has a name by which it may be 
accessed. An address (pointer) designating a specific location in the 



(1) Or equivalently an absentee job is logged in at the user's request 
by the system, in which case, the console is replaced by the absentee 
input segment. 
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virtual address space is a pair of numbers: a segment number and an 
offset within the segment. When a segment is to be used, it is 
initiated forming a mapping between the name and a segment number. 
This mapping remains valid for the duration of a process, or until the 
segment is explicitly terminated . Use of sn invalid segment number, 
in particular a segment number generated in another process, is a 
common source of errors. (See the description of the segment fault 
error.) An offset within a segment, on the other hand, remains valid 
as long as the contents of the segment are not modified. This means, 
for example, that it is possible to save the offset part of an address 
across processes and reuse the offset with a segment number generated 
in the new process. (1) Errors occur in the use of offsets if the 
value of the offset is out or range: negative or greater than 255K. 
(A lower limit can be set by explicit programmer action, if desired.) 
See the discussion of out of bounds errors, 

A segment may be designated by one of two naming conventions : 
pathnames and reference names. In general, a segment is specified by 
pathname when accessed by commands, and by reference name when 
accessed from a program as an external symbol (e.g., the name of an 
external subroutine), 

A pathname designates an unique segment within the Multlcs file 
system . ^^Every segment has one or more entrynames by which it is 
cataloged in a directory . Within a single directory, the entrynames 
of all entries are unique; entrynames of entries in different 
directories need not be distinct. In addition to segments, a 
directory may contain other subdirectories. The Multics file system 
is organized as a tree with a root directory that contains all other 
directories as subdirectories, subsubdirectories , etc. 



(1) PL/I programmers may realize the similarity between this and the 
restrictions on the use of based areas and offsets on other systems. 

Programs are not allowed to save pointers to data allocated within the 
area from job to job because while the area may retain its integrity, 
the actual address may change. The same reasoning applies to segment 
numbers and offsets, and to areas on Multics saved from process to 
process . 
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A pathname, then, is an ordered list of entrynames designating the 
directories containing the entry and the entry itself. It gives the 
path from the root to the segment. In the diagram above, squares 
represent directories and diamonds represent segments. The following 
are all valid pathnames within that hierarchy: 

>d1>a 
>d2>a 
>d2>a>a 

In addition to segments and dlr ?ctories, a directory may also contain 
links . A link is a pathname pointing to another entry (usually in 
another directory); it allows that entry to be accessed as if it were 
cataloged in the directory containing the link with the name(s) of the 
link. In the diagram above, links are presented by triangles with 
dotted lines leading to the target of the link. 



dl 

y \ 
/ \ 
/ \ 



(a) 



\ 

\ c / 
\ / 
\/ 



>d1>c and >d2>a, 
and >d1>c>f and >d2>d 



refer to the same directory and segment respectively. If a link 
points to another link, then the entry pointed to by the second link 
becomes the ultimate target. 

There are two forms of pathnames. An absolute pathname contains the 
entrynames of all the containing directories; FFat is, it fully 
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specifies the position of something (i.e., segment, directory, link) 
within the directory hierarchy. A relative pathname , on the other 
hand, gives the position of an entry relative to the working 
directory . A relative pathname is expanded into an absolute pathname 
by logically concatenating the pathname of the working directory to 
the relative pathname given. For example, if the working directory 
were >d2>a from the the diagram above, the relative pathname "f" would 
be the same as the absolute pathname >d2>a>f . It is possible to move 
upwards in the hierachy by using "<"s in a relative pathname. Thus 
with the same working directory as above, <d would be the same as 
>d2>d. The working directory is initially the user^s home directory , 
normally >udd>Project ID>Person ID; it may be changed by the user 
with the change__wcfir (cwdT command. Absolute pathnames ar6 
distinquished from relative ones by a leading ">". 

The term segment is often confused with the term file . Strictly 
speaking, a file is storage accessed through explicit input/output 
operations. In principle, there are no limitations on the size of a 
file; it may get as large as is necessary, far exceeding the 255K 
word limit of a segment. Those files smaller than 255K are placed in 
a single segment. Unstructured files of character data are the same 
as text segments. That is, they may be created or modified in an 
editor, printed, or sorted. Structured files (those containing 
nonprintable "binary" data) should not be acessed except through I/O 
facilities. Those files larger than 255K are implemented as 
multisegment files . The data is stored in several segments which 
should only be accessed by I/O mechanisms. Even if the file contains 
only printable text, there are currently no mechanisms for editing it 
and guaranteeing the authenticity of the file. A multisegment file is 
cataloged in a directory like any other entry. In this memo, the 
distinction between file and segment will be strictly adhered to, 

A reference name is the name by which a segment is referenced (e.g., 
called) during the execution of a program. It consists of the 
entryname of the segment; the absolute pathname of a particular 
segment is determined by applying the search rules in effect for the 
process. They are as follows. 

1. A list of reference names already known within the process is 
checked; if the entryname being searched for is found, the 
associated segment is used. A name becomes known when the 
search rul es are first used to reference a segment with that 
entryname or when a specific segment is initiated and a 
reference name (which need not be an entryname of the segment) 
is specified for the segment. 

2. The directory containing the program making the reference is 
checked for a segment with the entryname. If found, the 
segment found becomes known by the reference name. 

3. Each of an ordered list of directories is checked for a 
segment with the correct entryname. If found, the segment 
becomes known by the reference name. Initially, this list 
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starts with the user's working directory and is followed by 
the list of system libraries. Alterations may be made to this 
list of directories by using the add__search rules command. 
For example, the working directory (whicTi is logically 
specified as "working_dir" and whose meaning changes as the 
working directory is changed) may be moved to follow the 
system libraries, or a specific user directory may be added to 
the search rules. 

Once a reference name is associated with a particular segment, it 
remains in effect (rule 1) until the process is terminated or until 
the segment is terminated by using the terminate command. This can 
cause unexpected results for the unsuspecting user. In the sample 
hierarchy given above, if the user's current working directory is >d1 
and he or she executes the procedure a in that directory, it will 
become known by the reference name a. If later, he changes to a new 
working directory, >d2>a, and executes the procedure f which calls a 
subroutine a, then the segment with reference name a found by the 
search rules will not be the segment >d2>a>a, but rather the segment 
previously known by that reference name, >d1>a. 

For each process, the system creates a process directory . This 
directory contains temporary data segments and special segments in 
which program data and system control information are stored. The 
stack is one such segment and contains records of current procedure 
activations and the automatic storage used by these procedures. The 
combined linkage segment contains the linkage sections of procedures 
which hold the internal static data used by a program. The identity 
of these segments can be important in determining the cause of an 
error. When an error occurs, the segment containing the data being 
referenced will be given when appropriate. If the segment is the 
stack, it is a strong clue that the operation causing the error was 
making use of a datum of automatic storage. Similarly if the segment 
is the combined linked segment (combined_linkage__r .nn) , it is likely 
that static data is involved. Often such a clue can be used to 
isolate the cause of an error in the absence of other debugging 
information such as the line on which the error occurred. 
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The list of procedure calls contained in the stack is an extremely 
useful source of debugging information. Consider the following 
example. Assume that a procedure A is executing. It then calls 
procedure B. B in turn calls C. When C has finished executing, it 
returns and B continues from the point at which it called C. B 
eventually returns, and A then calls the procedure C. At each step, 
it is possible to construct an ordered list of the procedure 
invocations indicating which program called which other program and 
the location in a program at which it called out. Graphically, this 
list may be represented as follows: 

C 

B B B C 

A A ' A A A 

A calls B B calls C C returns B returns A calls C 

In the figure above, the most recently called procedure is on top. 
Such a stack trace is particularly useful to understand the sequence 
of calls that lead up to an error. The probe and trace_stack commands 
may be used to obtain a stack trace. Examples of the use of the probe 
command are given in later sections. A block is act i vated when a 
procedure or subroutine is called or a begin block is entered. 
Activation causes dynamic allocation of storage for a program's 
automatic variables. The area allocated is placed at the end (top) of 
the process's stack and is called a stack frame . When the procedure 
returns, the stack frame is freed. This means that variables of the 
automatic storage class (1) only have storage assigned to them (and 
hence a legitimate address and value) when the block in which they are 
declared is active (i.e., its execution is ongoing or suspended as the 
result of an error condition, a quit signal, a call, or a debugger 
breakpoint). When a procedure is called recursively, it has frames on 
the stack for each activation. Each instance of the procedure on the 
stack is considered a separate and distinquishable activation of the 
procedure. The values of automatic variables and parameters can be 
(and usually are) different in different activations of the same 
procedure . 

Within a process, PL/I static variables and Fortran variables have a 
continuity of value. That is, the value of such a variable is 
initialized only once during a process, when a program in which the 
variable is defined is first invoked; subsequent modifications to the 
value of the variable will remain in effect, even through new 
activations of the procedure, until the process is terminated. (2) 



(1) PL/I variables, by default, belong to the automatic class. 
FORTRAN variables appearing in an automatic statement (a nonstandard 
Multics feature) are also of this class. 

(2) PL/I internal static variables or Fortran variables that are not 
in common may be reinitialized by terminating the segment. External 



1-7 



CONVENTIONS 

The examples in this document follpw certain conventions. All lines 
typed by the user are prefixed by an exclamation point ( ). A quit 
signal issued by the user by pressing the QUIT, ATTN, or BREAK keys on 
the terminal is indicated by "(quit)*' appearing to the left of the 
normal text of the example. When a line of output is too long to be 
placed on a single line, it is broken at an arbitrary point. This 
should not affect the user's understanding of the example. In ready 
messages output by the system on the completion of a command line, a 
dot (.) replaces information, such as the time of day, irrelevant to 
the example being presented. Finally, many lines of input or output 
whose content should > be obvious from the example is replaced by 
ellipsis (...). In all other respects, an attempt has been made to 
produce examples which are accurate. Most are simply modifications of 
the output from test error situations. 



and commoned variables may be reinitialized 
command to obtain a new process. 
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only by using tne new pro^ 



SECTION II 



COMMAND PROCESSOR ERRORS 



These are errors that are detected by the command processor When this 
kind of error is detected, a message is printed on the console, (along 
with a ready message) , and then the system waits for the user to type 
another command. Once the cause of the problem has been determined, 
the user may retry the (corrected) command. 

These errors may often be caused by a garbled telephone connection 
between the user's terminal and the computer. If there is no apparent 
cause for an error, reenter the same command line again. 



SEGMENT NNNN NOT FOUND 

This means that reference name NNNN did not match any reference or 
entryname within the user's search rules. The most common cause of 
the error is incorrectly specifying (through mistyping or a 
misconception) the command name. 

For example, suppose that a user had a program called colour, but 
mistakenly typed "color" when calling it: 

color 

Segment color not found. 



r 



list 



Segments s 3» Length s 3* 



re 
r w 
rew 



1 colour 

1 colour.pn 

1 PJApple.mbx 



r 



colour 



Here the user gets the error, then uses the list command to see if 
there was something wrong with the name. Finding the mistake, the - 
command line is retyped with the corrected name. 

This error is virtually identical to the "segment not found" case of 
linkage errors. See that discussion below for additional examples. 



ENTRY POINT EEEE NOT FOUND IN SEGMENT 

This indicates that a segment matching the reference name NNNN was 
found in the user's search rules, but it did not contain the entry 
point called EEEE. To determine what entry points are actually 
present in a program (or other type of object segments) the 
print_link_info command may be used. 

colour 

Entry point colour not found in segment colour, 
r • • • . 

pli colour -entry 

colour 02/05/76 15^0.^* est Thu 

3 Definitions: 

segname: colour 
symblO symbol table 

text! 17 colour"" Entry: text|17 

r t • • • 

colour$color 
• • • 

In the above example, a segment matching the reference name colour 
(see previous example) was found but it did not contain an entry point 
"colour". The pli command gives the "segname" or the name by which 
the program was known when it was compiled; the only "entry" defined 
is one called "color". The user corrects the line by giving a command 
name that contains both the reference name and entry point' name 
separated by a "$". Another way to correct the error would be to 
rename the program ( both the source and the object segments ): 

rename colour. color. s= 
r . . . • 

color 
r .... 

In this way, the segment now has the same entryname and entry poin' 
name and can therefore be called as a command by giving only it;. 
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entryname. (1) 

The problem illustrated here occurs quite often when the program 
contains a procedure with a different name than that given to the 
segment containing the text of the program, 

edm colour. pi 1 
Input. 

color: procedure; 



end color; 

Edit, 
w 

q 

r . . • • 

There are a number of other causes for this error. The entrypoint may 
have been deleted by binding. 

This error is virtuall^^ identical in cause to the "external definition 
not found" case of linkage errors. See that discussion below for 
additional examples. If the meaning of reference names versus 
entrynames and entry point names is confusing, see the MPM Reference 
Guide , Section III, Constructing and Interpreting Names. 



EXPANDED COMMAND LINE IS TOO LONG 

This error arises when an active string has been used, and the string 
returned overflows the currently allocated size for the command line. 
The user may recover by using the set_com_line command to set the 
command line length to some arbitrarily""large value (e.g., 3000) and 
reissuing the command line. Below, the active string segs is invoked 
to return a string containing the names of all PL/I and Fortran source 
segments; this string overflows the command. line length. 

archive ad saved^programs [segs •.pH ••fortran] 
command_processQr_: Expanded command line is too long, 
i .... 

set_com_line 3000 
r .... 

archive ad saved programs Csegs *.pl1 *. fortran] 



(1) For an explanation of the star and equals convention, see the MPM 
Reference Guide , Section III, Constructing and Interpreting Names. 
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IMPROPER SYNTAX IN COMMAND NAME 

This error is issued when the user has specified a command name which 
is not in the standard form of a reference name, optionally followed 
by the special character and an entry point name. Examples of 

correctly formed command names are: 

ref_name ref_name$entry_point_name 

Examples of incorrectly formatted names are: 

name$ $name 

More detailed information may be found in Section III of the MPM 
Reference Guide. 



BAD SYNTAX IN PATHNAME 

This means that the pr^ogram to be invoked was specified by an 
incorrectly formed absolute or relative pathname. See the discussion 
of the error in the Command Errors section. 



PARENTHESES DO NOT BALANCE 

This means simply that a parenthesis beginning an iteration set wa^ 
unbalanced. For example: 

create >udd>Serpent>PJApple>(output 1 outputs 
command^processor^: Parentheses do not balance, 
r .... 

What was intended was **( output 1 output2)** to create two segments. 
This error is handled by reentering a command line containing a 
balancing parenthesis. 

The problem may arise when iteration of a command is not intended. 
For instance, the "send__message" command which transmits its arguments 
to another party. 

send_message BDLucifer Serpent delete the files (in PJApple>old 
command_processor_: Parentheses do not balance, 
r • . . • 

Here the intent is to send a message containing a parenthetical 
thought. If the command line were reentered with a trailing 
parenthesis, two messages would be sent. That is, the user named 
would receive 

from PJApple. Serpent : delete the files in 

s: delete the files PJApple>old 



Notice that the first message contains the first string in the 
iteration set "(in PJApple>old)**, and the second message, the second 
string. This problem may be avoided by enclosing the entire message 
in quotes. 

send^message BDLucifer Serpent "delete the files (in PJApple>old) " 
r • • • • 

It is advisable to always enclose messages in quotes to avoid 
unintentionally sending someone repeated messages. 



BRACKETS DO NOT BALANCE 

An invocation of an active function (a procedure returning a string to 
be inserted into the command line) is enclosed in square brackets. 
This error simply means that the command line had an unbalanced left 
or right bracket. 

list -pathname Cpd 

command^processor^: Brackets do not balance, 
r • » . • 

The correct command line would have contained "Cpdl" to return the 
name of the user's process directory. The error may be handled by 
entering a corrected command line. 

In a manner similar to that described for the case of unbalanced 
parentheses, an unintentionally balanced active function invocation in 
a "send^message" command line will transmit a message containing the 
value of the active function. The problem may be avoided by enclosing 
the message in quotes. 



QUOTES DO NOT BALANCE 

Quotation marks may be used in a command line to delimit a single 
string argument that contains special characters such as •*(", "3", or 
space. The error means that the command line contained an unbalanced 
quote. The error may be remedied by reentering the corrected command 
line. 
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SECTION III 



COMMAND ERRORS 



These are errors detected in the processing of a command. They 
reflect not hardware conditions, but rather software conditions 
concerning, for example, the file system. Command errors are not 
restartable. A message is printed, and the system resumes what it was 
doing (e.g., listening for commands). The cause of the error may be 
fixed, and the command reissued. 



BAD SYNTAX IN PATHNAME 

This means that a pathname (the ordered list of entrynames identifying 
a segment in the storage system) has been formed incorrectly. The 
causes of this errc ' are typing mistakes and an incomplete 
understanding of what a pathname is. (In the latter case, see the NiPM 
Reference Guide , Section III, Constructing and Interpreting Names.) 

print >udd>Serpent>>PJApple>a.basic 

print: Bad syntax in pathname. >udd>Serpent>>PJApple>a .basic 
r • • • • 

print >udd>Serpent>PJApple>a. basic 



Here the user gave a pathname with two ">"s next to each other. As 
this is incorrect syntax, an error message was printed. The user 
recovered by typing the correct pathname. This error will also occur 
if a appears out of place in a relative pathname, that is, at any 
place other than the beginning of the pathname. For example: 

<<Student<Green>old. runoff 
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INCORRECT ACCESS ON ENTRY 



This means that the user, when logged in under the current project, 
does not have the correct access to a segment to perform a certain 
operation. This error can be dealt with by using the command 
"list_acl" (la) to determine why the user has no access, who can give 
him or her access, and if the user can do it him/herself, use the 
set^acl command to set the appropriate access to the segment. 

The error may arise when trying to read a segment or file. For 
example, when reading a segment with an editor (edm or qedx), when 
printing a file (using print or dprint) , or when trying to compile a 
source program. In this case, the user does not have "read" access to 
the segment. For example, the following dialogue might occur for user 
Green logged in under the Serpent project. 

edm color, pi 1 

edm: Incorrect access on entry. >udd>Serpent>PJApple>color .basic 
r . . • • 

list__acl color. pll 

r w BDLucifer .Serpent .* 

r w * .SysDaemon .* 



set_acl color. pll r 
r .... 

edm color. pll 



Here the user has attempted to edit segment color. pll. The edm 
command detects that he does not have read access to the segment, and 
reports an error. By using the "list_acl" command, he finds that only 
one other user on the Serpent project (BDLucifer .Serpent) has access 
to the file. The "set_acl" command is used to give Green . Serpent 
access to the file, and he retries the command over again. The error 
may also occur when writing out a segment that is being edited. In 
this case, the user does not have "write" access to the segment. 

edm color. pll 
Edit. 



... 



w 

edm: Incorrect access on entry. >udd>Serpent>PJApple>color . p] 1 
E set^acl color. pll rw 

Edit, 
w 

q 

r • . . , 
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Here the user tries to save a program that he has been editing, but 
cannot do so because he does not have write access to the segment. He 
is faced with the problem of setting the access on the segment without 
losing the editing that he had done. The edm "E" requests allows him 
to execute a Multics command line, so this feature is used to let him 
invoke the set_acl command to recover from the error. After the 
access is changed, the edm write request may be reissued. If the user 
had been unable to change The access, he could at least save what was 
done by writing it out into another segment as shown below: 

E set^acl color. pll rw 

set acl: Incorrect access to directory containing entry. 
Edil. 

w color 1 .pll 
q 



INCORRECT ACCESS TO DIRECTORY CONTAINING ENTRY 

This error means that the user on his or her current project does not 
have enough access on the directory in which a segment is (to be) 
cataloged to perform some operation on it. Again, this error can be 
dealt with by using the list_acl and set_acl commands. 

This error most commonly occurs while trying to delete a segment (the 
user lacks modify access), while trying to set the access on a segment 
(lacks modify) while trying to move, create, or copy a segment (lacks 
modify and/or append), or while trying to find out information about 
the segment (lacks status permission). 

status <BDLucifer>souls.list 

status: Incorrect access to directory containing entry. 
>udd>Serpent>BDLucifer> souls. list 

r • • • • 



list_acl >udd>Serpent>BDLucifer 
sma BDLucifer .* .* 
sma * .SysDaemon .* 
r . . . . 

list_acl >udd>Serpent 
sma *. Serpent 
sma * .SysDaemon ,* 

r .... 

set_acl <BDLucifer s 
r .... 

status <BDLucifer>souls.list 
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Here the user attempts to find out information about the segment. The 
status command requires at least "s" access to the containing 
directory, and not having it, an error message is issued. The user 
then checks the fact, and looks at her access to the parent of the 
directory containing the segment to see if she can set the appropriate 
access herself. She then gives herself the necessary access, and 
reissues the command. 



SOME DIRECTORY IN PATH SPECIFIED DOES NOT EXIST 

This means that a directory specified in the pathname of a segment 
does not actually exist. 

The way to determine what directory is missing and/or the entryname of 
the directory actually intended is to use the list command. 



print >udd>Serpent>t>Apple>color .pll 

print: Some directory in path specified does not exist. 
>udd>Ser pent>PApple> color .pi 1 

r • • • • 

list -pn >udd>Serpent -dr 

Directories =2. 

PJApple 
sma BDLucifer 

r • • • • 

print >udd>Serpent>PJApple>color .pl1 

• • • I • '. 



ENTRY NOT FOUND 

This means that a segment specifed was not found in the directory. 
(All the containing directories do exist.) 

This error may be dealt with by using the list command to see if the 
segment exists under some other entryname. The rename or addname 
commands can be used as desired to change the segment's entryname or 
give it an additional entryname. 

A common cause of this error in the case of novice users is misnaming 
the segment. For example, a Fortran source program must have the 
suffix ".fortran". Thus if the segment "main" had been created 
containing the program, an error would ensue: 
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edm main 
Input. 

• • • ' 
w 

q 

fortran main 
Fortran 

fortran: Entry not found, main, fortran 
r . . • . 

rename main main. fortran 
r • . . • 

fortran main 

• • • 

If the name identifies a link, then another possible cause of the 
error is that the segment pointed to by the link does not exist. This 
possibility can be checked by listing the link and checking whether 
the target exists. (Note'that the link target may be another link, in 
which case the process must be repeated.) 



INSUFFICIENT ACCESS TO RETURN ANY INFORMATION 

This error arises in the cases described for the above four errors 
when the user does not even have enough Access to determine why the 
operation cannot be performed. The problem is that the user does not 
have status permission on the directory containing a segment or, in 
the second case, to the directory containing the directory containing 
the segment. 

This error can be dealt with as describied above by first setting 
access on the containing directory. Usually, a user who receives this 
error will not have access to set the required access, and will have 
to contact the user who controls the directory in question. 



ILLEGAL ENTRYNAME 

This message is generated by an editor when the user tries to write 
from an editor buffer into a segment with a malformed name. A 
malformed name is one which contains special characters such as blank, 
tab, "/", etc., or which contains missing components. Generally, this 
is a name which would make it difficult to access the segment because 
of system conventions. Examples of illegal names are: 
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a«b 

ho/whose/ 
c . .d 
prog. 

This almost always occurs when the user has given an accidental write 
request. For example: \ 

edm second .fortran 

Edit. 

• . • 

w = a*b 

edm: Illegal entryname. = a*b 
... 

If it is desired to have a segment with a name containing such special 
characters, the segment can be written with a normal name, and renamed 
to the entryname containing special characters. 
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SECTION IV 



EXECUTION ERRORS 



This class of errors includes all hardware and software detected 
faults and conditions. When an error of this sort occurs, a condition 
is signalled. The condition may be handled by a user-supplied 
condition handler (PL/I on unit), or if no on unit is found (as is 
normally the case), the system's on unit. The system's on unit prints 
an error message and invokes a new command level, suspending the 
execution of the program causing the error. This new command level is 
indicated by a ready message with a level number greater than one: 

r 1204 2.039 39.200 3^7 level 2,16 

After an error has occurred, and a new command level entered, the user 
should eventually do one of three things: 

1. Issue a release command to flush execution of the suspended 
program. For example, a quit signal (sent by striking the ATTN, 
BREAK, or QUIT key on the terminal) may be used to stop a run away 
program, or excessive printing. 

looper 

(quit) 

QUIT 

r .... level 3 , • 
release 



The release command need not be used immediately after the error 
occurs. If the cause of the error is not obvious, system supplied 
tools (e.g., probe) , may be invoked at the new, command level to 
determine the cause. Whether or not this is possible, the release 
command should be issued before doing any additional work (e.g., 
changing and recompiling the program) to avoid more serious and 
incomprehensible errors. 



2. The start command may be used to restart the program that was 
interrupted. This is possible if the problem is correctable, or in 
the case of an erroneous computation where the system's on unit 
performs some specified action to correct the condition upon 
restart. Such a correction might be to set the result of the 
computation/ 2 ** -1000, to 0 after an underflow condition has 
occurred. The actions taken by the system on unit are often 
specified in the error message; if not, the user may consult the 
^'^^ Rgf gi^ence Guide if he or she desires. 

Another common practice is to "quit" out of a program that appears 
to be looping, check the CPU time that it has used by inspecting 
the ready message, and if it is looping, releasing the suspended 
program (after debugging the cause of the loop); otherwise, 
resuming the execution with "start". (Note: quit/starting in this 
way may lose output directed to the terminal. However, under 
certain circumstances, this may be desirable.) 

count 
1 

2 

(GUit) 

QUIT 

r .... level 2 , . 

start 
6 
7 

(quit) 

QUIT 

r .... level 3 1 . 

release -all 
r . . . . 

Here a program named count has been invoked. It was then stopped 
by a quit signal and restarted by the start command; as a result, 
a few lines of output were lost. The program was then stopped a 
second time by a quit signal and aborted by the release command. 
Notice how the level numbers are effected by this sequence. 

3. Issue the new^proc command to get a new process. This will 
reinitialize ^all static variables, common blocks, I/O attachments, 
files, etc. The use of this command is recommended when 
inexplicable (1) errors occur. Once a new proc is finished, it is 



(1) Errors for which you can see no apparent reason. For example, yov 
followed a memo verbatim; exactly the same thing worked before; an 
so forth. In general, a new^proc should be tried if you have not seen - 
the error before and cannot find a ready explanation. 



advisable (1) to retry the program with which there is a problem. 
Often the problem will disappear. If it doesn't, it is likely that 
a program bug exists, and you should continue to look for some 
other cause. The thing to remember is that an erroneous program 
can cause other programs including system programs to go awry. 

The error messages produced for most of this class of runtime errors 
are in a common format. For example: 

Error: Attempt to divide by zero at >udd>Serpent>PJApple>prog ! 1 3 (line 
system handler for error returns to command level 

The first line gives the type of error "Attempt to divide by zero" the 
pathname of the object segment causing tjhe error (>udd> . . . >prog) , the 
offset in the program object segment of the instruction at which the 
error occurred (13 octal), and, if the program were compiled with the 
"-table" option, the source line number. The second line gives 
additional information about the error. Here it states that a new 
command level will be created. 

In general, an error which occurs in a system program can be traced to 
a user error. (2) In the case of an error . in a system program, the 
user should verify that he has called it properly: that the correct 
number of arguments have been passed, that all documented requirements 
and restrictions have been met, and that all values passed as input to 
the system program have reasonable values. 

When an error occurs in a system program, the location in the user 
program where the system program was called is not given in the error 
message. This location can be determined using the probe command. 



(1) If the cost of program execution prior to occurrence of the error 
is acceptable. 

(2) This is not to say that there are not bugs in system programs, 
however it is more likely that the user did something wrong. 
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prog 



V 



Error while processing in ring 0: 

Segment- fault error by bound_system_faults I 2M330 

referencing 177710 

There was an attempt to use an invalid segment number. 
Entry into lower ring was by 
change_wdir$get_wdir_I M76 
(>system_library standard>bound_f scom1_) 
referencing hcs_^fs_search_get_wdir 
r .... level 2, . 

probe 

Condition seg_fault_error raised at get_wdir_| 163^^ . 
stack ~" ~ 

11 command_processor_ 
10 release_stack 
9 unclaimed^signal 
8 def aul t_error_handler_ 
7 real_sdh_ 

6 get_wdir_ seg_fault_error 
5 prog 

^ command_processor_ 

3 listen^ 

2 process_over seer_ 

1 user_init__admin_ 
use prog 
source 

this -> wdir = get_wdir_ (); 
where source ^ 
Current line is line 9 of prog. 



The error message may be interpreted as follows. The error was a 
segment fault error. The message "Error while processing in ring 0" 
indicates that the error occurred in a supervisor program. The 
supervisor program was called from the user ring by the program 
change_wdir$get_wdir_ (which is located in a bound segment in a system 
library). (1) The error message does not indicate what user program 
called these programs. This is determined by invoking probe, and 
issuing special requests to it. The stack request lists the procedure 
activations currently on the user stack (the called procedures). Here 
"get_wdir_" has been called by the user program "prog". The use 
request tells probe to examine "prog", and the source request then 
gives the text of the line at which the error occurs; "where" 
retrieves the line number of that line. Note that these (and most 
other) probe requests can only be used as shown when the program in 
question has been compiled with the -table option. 



(1) The other information is largely irrelevant for the purposes of - 
the casual user. 



RECORD QUOTA OVERFLOW 



This means that the disk storage quota for a directory has been 
exceeded. The problem can be dealt with only by finding or reclaiming 
additional disk quota. Usually, it is possible to have the storage 
quota on a directory increased by the project administrator, (1) 
Quota can also be temporarily reclaimed by deleting unneeded segments, 
or if possible moving a segment to a directory with unused quota. 

This error will occur when a segment is being written into. There are 
three common contexts in which this will occur. Writing out an editor 
buffer, compiling a program to produce an object segment, and 
outputting a file from a user program using language I/O facilities. 
The following is an example of a record quota overflow occurring while 
writing an editor buffer. This is a particularly dangerous problem 
for if it can not be corrected, the changes made to the text or source 
file will be lost. 

edm prog .pi 1 
Edit. 

.• • • 

w 

Error while processing in ring 0: 

record_quota_overflow condition by bound file system 13627 
referencing >udd>Serpent>PJApple>prog .plT! 300^6 

Entry into lower ring was by 
>system_library_standard>edm 1 50^7 
referencing hcs_$truncate_seg 
r .... level 2 , . 

get_quota -wd 
quota = 2; used =2 
r .... level 2 , . 

list 

Segments = 3i Lengths =2. 

re 1 xxxx 

r w 0 prog.pH 

r w 1 xxxx.pH 

r .... level 2 , * 



(1) This is normally the person or group through which funding has 
been arranged. For most users, this will be the User Accounts Office. 
Students in courses should contact their instructor. Users on the 
Student project, should contact the SIPB. 



delete xxxx 

r .... level 2 , . 



get_quota -wd y 
quota = 2; used = 1 
r .... level 2 , . 

start 

q 

r * a . . 

When the user tries to save his changes to the file "prog.pll", the 
error occurs. The error message indicates that the error occurred in 
a supervisor routine called from the editor program. 

The get_quota command gives the current value of the quota and the 
number of records currently charged against it. The list command 
gives the lengths (see below) of the files in the directory as well as 
their names. The user then deletes the object segment "xxxx" to make 
room to write the file in the editor. (Note that information is not 
being lost here, as the source file "xxxx.pll" can be recompiled to 
create the object segment once sufficient quota has been obtained.) 
The get_quota command shows that a single record of storage has been 
freed up, and the start request causes the editor write operation to 
be restarted. Since he is finished editing, the user quits out of the 
editor. 

If the user then tried to compile the program, another record quota 
overflow would occur because with the file "prog.pll" successfully 
written, the number of records used is once again two. 

pll prog -table 
PL/I 



Error: record_quota_over f low condition by compile_entr y ! 62 T 
Osystem library standard>bound_cg_) 
referencTng >uddySerpent>PJApple>prog 1 0 

r .... level 2 , . 



In this particular case, the user can do nothing to gain additional 
storage, except delete the source file xxxx.pH. If the file were of 
no use, the choice of deleting it would be acceptable; and the user 
could restart the compilation with the "start" command. If it were 
unacceptable, the user could only wait for additional storage. The 
problem would not be as critical as in the case above, as no 
information would be lost by logging out. 



The third context in wh.^ch a record quota overflow might occur is in r 
user program that writes output to a file. 



filewriter 



Error: record_quota_overflow condition by open^uns__f ile$put_chars_un 
Osystem library_standard>botsnd_vf ile_) 
referencTng >udd>Serpent>PJApple>output_f ile j 0 
r .... level 2 , . 

Note: The list command normally will give the "length" of the 
segments listed. This is the apparent size of the segment as computed 
from the bit count. However, bit count can be inconsistent with the 
number of records used by the segment if the segment contains zero 
page(s) (see above), or if the bit count has never been set (which can 
occur for a file which was never closed or a data structure or common 
block overlaid on a segment). Continuing with the example above: 

get quota -wd 

quoTa = 3; records =3, 

r . • • • 

list 

Segments = 2, Lengths s 

re 3 test 

r w 1 test.fortran 

r . . . • 

The get quota command shows 3 records now in use (an additional record 
filled Th by completing the compilation); but the list command shows 
lengths totaling four records. If the "-records" option is supplied 
to the list command, the actual records used by the segment will be 
given. 

list -records 

Segments = 2, Records =3. 
2 test 

1 test.fortran 

r . . a . 

This is consistent with the results given by get_quota. The point is 
that when looking for segments to delete or move when reclaiming disk 
quota, the "-records" option should be used to obtain the correct disk 
usage for the segment. In addition. It cannot be assumed that a file 
is empty because its length is zero. Rather, it is empty only when 
its records used is zero. 



LINKAGE ERROR 



This error will occur when a program tries to reference an external 
symbol, for example, an external program or PL/I external data, and 
the specified symbol is not found. If the source of the error can be 
determined, and the problem fixed, the program can be restarted. Note 
that it is possible to "fix" a linkage error in such a way as to cause 
another flavor of the same error to occur when the program is 
restarted, A little thought will prevent this from happening however. 

There are four subclasses of linkage errors: 



Segment Not Found 

It means that a segment with the specified reference name was not 
found anywhere in the user's search rules. For example, assume that 
procedure "prog" calls another program, "zzzz$aaaa", which for some 
reason cannot be found. 

prog 

Error: Linkage error by >udd>Serpent>PJAppie>prog i 20 (line 3^) 
Referencing zzzzlaaaa. 
Segment not found, 
r .... level 2 , . 

The basic approach for dealing with this error is to list the 
directories within which the program or data segment was thought to be 
in order to determine which of the following four cases apply. 

- the segment referenced really did not exist 

- the segment referenced exists, but its name was given 
incorrectly (e.g., misspelled), 

- an entry (segment or link) of the correct name exists within the 
search rules, but was ignored 

- the referenced segment exists in a directory not in the search 
rules. 

The typical user who is working alone, (i.e., not using programs in 
some "private" library) and is only using his own programs, standard 
system commands and subroutines will usually only have to consider the 
first two cases. Below is a further description of each case. 

a. The segment may not exist. For example, it may have never been 
created, A common problem for new users is forgetting to compile the 
program. Continuing with the above example: 



list 



Segments = 3, Lengths = 3. 

re 1 prog 

r w 1 zzzz.fortran 

r w 1 prog.pll . 

r .... level 2 , . 

Notice that there are source and object segments for prog, but only a 
source segment for zzzz (zzzz.fortran). The cause of the problem 
then, is that there is no object segment named "zzzz" to be found. 
Compiling the program (as shown below) will create such a segment; 
restarting execution will cause the search for the segment to be 
repeated, and this time found. 

fortran zzzz 
fortran 

r .... level 2 , . 
list 

Segments = Lengths r 4. 

re 1 zzzz 

re 1 prog 

r w 1 zzzz.fortran 

r w 1 prog .pll 

r .... level 2, . 

start 



b. No segment of the designated name may exist. This can happen if 
the user is confused about the name of the segment. For example, if 
a PL/I program is called "subr" (i.e., subr is the label on the 
procedure statement) but the program resides in a segment of another 
name (e.g., subroutine), calling "subr" from another program will 
cause this error. This problem can be fixed by renaming (with the 
rename command) the segment (and the source segment) containing 
"subr". 

rename subroutine.** subr,s= 
r .... level 2 , . 

c. If the search rules have been stated as the user desires,, and 
there is in fact a segment of the correct name in one of the 
directories in the search rules, then the most likely cause of the 
error is that the user has no access to the segment. For example, a 
"list" might show 
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list -pn >udd>Serpent>PJApple 



Segments 



3, Lengths 



re 



r w 



1 
2 
1 



prog 
zzzz 
prog.pll 



r .... level 2, . 

Notice that there is no access ("re", "rw", etc,) listed for the 
segment zzzz. This problem should be corrected with as described in 
Section IIIB (Incorrect Access On Entry, etc.). 

The second cause of this problem is a link of the correct name which 
points to a non existent segment or a segment to which the user has no 
access. A non-existent segment can be caused by the segment having 
been moved or deleted or the target pathname being incorrect. This 
might appear In a listing of the directory as follows: 



list -pn >udd>Serpent>PJApple 
Segs=0;Msfs=0;Dirs=0;Links=l . 
r .... level 2, . 

list -pn >udd>Serpent>PJApple -link 
Links = 1 . 

zzzz > udd>Ser pen t>BDLucifer> zzzz 

r .... level 2 , . 

initiate >udd>Serpent>PJApple>zzzz 
initiate: Entry not found, zzzz 
r .... level 2, . 



The first list command (listing segments) shows that there are no 
segments in the directory, but that there is one link. The second 
list command shows the link to a segment in another directory. The 
initiate command is used to determine the reason why the segment 
pointed to by the link was ignored in the search. Here it does not 
exist. If the target pathname is incorrect in that a directory is 
named incorrectly, the command error "Some directory in path specified 
does not exist." would be reported. If the problem is no access, the 
error would be "Incorrect access on entry." 

d. While a segment of the correct name may be known to exist, the 
directory containing it is not in the search rules. The current 
search rules may be listed with the "print search rules" command. 



print_search_rules 
initiated_segments 
referencing dir 
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working_dir 

>system_library_standard 
>system~library~unbundled 
>systein__library_1 
>system_library_tools 
>system library_auth_maint 
r .... level 2,7 

list -pn >udd>Serpent>PJApple 
... 

Note that this is a common problem to users of packages such as BMD, 
IMSL, SSP, or the M.I.T. Calcomp subroutines. These programs are kept 
in directories outside of the normal search rules. (1) 

In general, when it has been determined that a segment to be 
referenced is outside of the search rules, one of three things can be 
done. The search rules can be adjusted to include the directory 
containing the segment; the segment may be initiated; or a link to 
the segment can be created. For example, assume that the segment in 
question is the IMSL subroutine eigrf. The search rules can be 
corrected with the "add_search_rules" command. (2) The problem could 
be resolved by: 

add_search_rules >libraries>imsl -after >system_library_unbundled 
r .... level 2 , . 

print_search_rules 
initiated_segments 
referencing_dir 
working_dir 

>system_library_standard 
>system_library_unbundled 
>libraries>imsl 
.... 

r .... level 2, . 

Here, the print_search_rule command has been used to show the 
corrected search"" rules. This approach is useful when the missing 
segment is one of a collection of programs in the same directory 
(like a program library) whose other members are also likely to be 
used. 



(1) The documentation for such program libraries will usually specify 
how to make use of those routines. This advice should be followed. 

(2) In the example below, the new search rule is added after 
>system_library__unbundled rather than after working_dir to avoid 
searching >librar iesMMSL every time a command or subroutine is 
referenced for the first time in the process. 



1 



The segment may also be initiated. This is useful when there is only 
one program needed, and it is likely to be used only within the 
current process. 

initiate >libraries>imsl>eigrf 
r .... level 2,. 

A link to the program may also be created. This need only be done 
once, and will enable the program to be referenced without issuing 
additional commands at any time in the future provided that the 
directory containing the link remains within the search rules. The 
simplest way to ensure this is to place the link in the directory 
containing the calling program itself. » , 

link >libraries>imsl>eigrf 
r .... level 2 , . 

where eigrf 
>libraries>IMSL>eigrf 
r • • . a level 2, . 

The "where" command gives the pathname of the segment whose reference 
name is given. That is the segment that will be invoked if a program 
of the name given is called. It has been used here to verify that the 
link was successful. 



External Symbol Not Found 

This means that a segment matching the reference name specified was 
found, but that the (perhaps implicitly) specified entry point was 
not . 

prog 

Error: Linkage error by >udd>Serpent>PJApple>prog 1 3^ (line 38) 
referencing xxxxlaaaa 
External symbol not found, 
r .... level 2 , . 

This means that the segment xxxx was found, but the external entry 
point (symbol) "aaaa" was not found in the segment. In addition to 
trivial naming and typing mistakes, one of the more frequent causes 
for the error is that the program resides in a segment with a name 
different from the one used on the procedure statement of the program. 
The program is then called using the segment name. 
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edm test.pH 
Segment not found. 
Input. 

tester: procedure (a); 

del a float binary(27); 

a = a »» 2; 
end; 

• 

Edit, 
w 

q 

r • « . . 

pll test -table 

PL/I 

r . . . . 

test 

Error: Linkage error by >udd>Serpent>PJApple>call_test ! (line 2U) 
referencing test 'test 
External symbol not found, 
r .... level 2, . 

This problem can be eliminated only by changing the name on the 
procedure statement from tester to test and recompiling the program. 



Linkage Section Not Found 

This means that a segment of the specified name was found, but that 

the segment did not have a linkage section (i.e., it is not an object 
segment) . 

prog 

Error: Linkage error by >udd>Serpent>PJApple>prog I 'IS (line ^2) 
referencing xxxx'aaaa 
Linkage section not found, 
r .... level 2 , . 

This may occur if the name of a data or test segment was specified 
instead of the name of an actual compiled program. For example, a 
common problem is a source segment which is given the name of its 
object segment. 
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list 



Segments = Lengths = M. 

r w 1 xxxx 

xxxx.pH 
re 1 prog 
r w 1 prog.pll 

r .... level 2,. 

The list command shows the two names on the source file "xxxx.pll". 
When "xxxx" was referenced from the program, it was this segment that 
was found, but it was not a valid object segment. 

To recover from this particular error, the name must be deleted from 
the segment, and the text compiled into the object program to be 
called. The program can then be restarted. 

delete_name xxxx 
r .... level 2, . 

pl1 xxxx 
PL/I 

r .... level 2, . 
start 



There is No Room to Make Requested Allocation 

This means that the size of a named external data area exceeded the 
system limit of 255K words. Examples of such areas are named common 
blocks in FORTRAN and external symbols given reference names (names 
containing a "$") in PL/I. For example 

nospace: procedure; 

declare bigarea$ (300000) external fixed binary; 
• • . 

bigarea$ (1) = ... ; 
... 

end; 

Executing the above program would produced the following error: 
nospace 

Error: Linkage error by >udd>Serpent>PJApple>nospace 1 1 1 (line ^ 

referencing bigarea! 

(with a create-if-not- found link) 

There is no room to make requested allocation. 

r .... level 2, . 



When such an error occurs in a PL/I program, the user should examine 
the declaration of the external symbol and calculate the size. If it 
is a structure containing elements each smaller than the limit, the 
structure can be broken up. For example 

declare 

1 extstruc$ external, 
2 a (100000) fixed bin, 
2 b (100000) float bin, 
2 c (100000) float bin(63); 

would occupy a total of '♦OOjOOO words of storage. Member a uses one 
word per element; b, a single precision real value, uses one word per 
element; and c, a double precision real v^lue, uses two words per 
element. It can be broken up into two or three small structures: 

declare 

1 extstruc1$ external, 

2 a (100000) fixed binary, 
1 extstruc2$ external, 

2 b (100000) float binary, 
1 extstruc3$ external, 

2 c (100000) fixed binary; 

If the symbol being created is one large array, then the programiner 
should attempt to reduce the size of the array needed. If such a 
reduction is not possible, it may be possible to simulate the array as 
an array of pointers to cross sections of the original array. 

declare 

array$ (3,100000) external fixed binary; 
would cause the error described here. This could be replaced by 
declare 

array (100000) fixed binary based, 
arrp (3) pointer initial 

(addr (array1$), addr (array2$), addr (array3$)), 
(arrayU, array2$, array3$) (100000) external fixed binary; 

with the program edited to replace all references to 

array (x, y) by arrp (x) -> array (y) 

Similar problems occur in FORTRAN when very large common blocks are 
used. As in PL/I, there are two cases: when there are many small 
members of the common block, and when there is one very big member. 
In the first case, the problem can again be dealt with by splitting up 
the common block. 
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common /data/ a(IOOOOO), bdOOOOO), c(IOOOOO) 

becomes 

common /datal/ a( 100000), b( 100000) 
common /data2/ c (100000) 

In the second case, that of one very large member, there is no method 
to get around the problem that is particularly efficient. The best 
that can be done is to write a function that references cross sections 
of the array defined in different common blocks. 

common array (3 t 100000) 

becomes 

function array (x, y) 

common /datal/ arrayl (100000) 

common /data2/ array2 (100000) 

common /dataS/ array3 (100000) 

go to ( 1 , 2, 3) X 

1 return (arrayl (y)) 

2 return (array2 (y)) 

3 return (array3 (y)) 
end 



SEGMENT FAULT 

This error means that the program has addressed a non-existent 
segment. What has happened is that an address value (pointer, entry, 
or label) contains an invalid segment number. There are two general 
causes: using an uninitialized address datum, and using an address 
value designating a segment after that segment has been deleted. 

A deleted segment may be referenced under the following 
circumstances. If the program was, at the time of being deleted, 
still active (its execution suspended by a quit signal or error 
condition). 

prog 

Error: Attempt to divide by zero at >udd>Serpent>PJApple>prog 1 2^ 
(line 12). 

System handler for error returns to command level, 
r .... level 2 , . 



delete prog 

r .... level 2, . 



• • • 



release 

Error: Segment-fault error by unwind_stack_| 120 
(>system_library_1>bound_sss_active_)'" ~ 
(while in pll operator cp_csa) 
referencing 36712 

There was an attempt to use an invalid segment number, 
r .... level 2 , . 

Or if the segment is an input or output file that was not closed prior 
to deleting the segment. 

prog 

(quit) 

QUIT 

r .... level 2 , . 

delete output file 
r .... level ^, . 

release 
prog 

Error: Segment- fault error by open uns_file$put_chars_uns_f ile j 1036 
(>system_library_standard>bound_vf iTe_) 
referencing 3^510 

There was an attempt to use an invalid segment number, 
r level 2,. 

An uninitialized address value is usually caused by forgetting to 
initialize the corresponding variable. (1) 



prog 

Error: Segment-fault error by >udd>Serpent>PJApple>prog I 327 
(line ^13) referencing 23^9127 

There was an attempt to use an invalid segment number, 
r .... level 2,. 

probe 

Condition segfault raised at line 43 of prog. 



(1) This can also cause any of the other bad address problems 
described under other errors. Ah uninitialized pointer may cause a 
worthless value to be displayed for a variable qualified by the 
pointer or for the pointer itself. (Most uninitialized automatic 
pointers point into the stack). 
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source 

p -> data = 3; 

value p 
23^9127 



In FORTRAN, address data problems may occur as well. One cause is 
passing an array argument to a FORTRAN subroutine whose corresponding 
parameter is not dimensioned. When the program references this 
parameter with subscripts, FORTRAN treats the parameter as an entry 
value. For example, executing a program of the following form 

subroutine mattran (arrin, arrout) 
dimension arrout(M,'l) 
. • • 

arrout (i,j) = arrin (j,i) 
... 

end 

could cause an error of the form 
mattran test 

Error: Segment- fault error by >udd>Serpent>PJApple>mattran 1 1^3 
(line 12) referencing 327'756 

There has been an attempt to use an invalid segment number, 
r .... level 2 , . 

probe 

Condition segfault raised at line 12 of mattran. 
source 

arrout (i,j) = arrin (j,i) 
value i; value j 
1 

1 

value arrin (i,j) 

Error: Segment- fault error by print^ref erence 1 2373 
(>system_library standard>bound_probe_| 1^517) 
referencing 3271756 

There has been an attempt to use an Invalid segment number, 
r .... level 3,. 

pi 

symbol arrin 

entry variable parameter 



Here, the subroutine mattran has been called from mattran test. A 
segment fault error occurs on line 12, and probfe is invoked to look 
for the cause of the problem. The "source" request gives the text o 
the statement in which the error occurred; "value" requests enable 
the user to determine with what variable the program is having 



4-18 



difficulty. The error reoccurs when the value of "arrin (i, j)" is 
displayed, indicating that "arrin" is the problem. The 
program_interrupt (pi) command is used to probe, and the "symbol" 
requests used to display the attributes of the variable. The output 
shows that it is an entry variable and not an array at all. 

Another cause would be passing too few arguments to a subroutine. In 
this case, referencing a parameter for which there is no corresponding 
argument may cause a segfault or other addressing error. 



NO EXECUTE PERMISSION 

This means that the user's process is attempting to execute a segment 
to which it does not have execute access. Upon getting this error, 
the user should attempt to set access (or have the access set for him 
by the owner of the segment) to read and execute, (1) and if 
successful, restart the program. 

prog 

Error: no execute permission condition by command_processor_| 522 
(>system_lTbrary_lTbound_command_loop ) 
referencing >udd>'Serpent>PJApple>progT3 
r .... level 2 , . 

set_acl prog re 
r .... level 2,. 

start 
... 

This can occur if the access has been set incorrectly on the segment. 
For instance, if a "set^acl ** rw" command has been issued in the 
directory, or if the user had created the object segment before 
compiling by using the create command. 

The error can also occur when an uninitialized label or entry variable 
is referenced. This particular case can be distinguished from the 
others by the identity of the segment being referenced. If it is one 
which could be expected to be called (e.g., in the example above, 
"prog" is being called), then the problem is probably a simple access 
error; on the other hand, if the segment , is a data or text segment, 
etc., then the problem is probably an uninitialized address datum. 



(1) At least "re" access is necessary for an object segment; "e" 
alone will not suffice. Write access is not advisable. 



NO READ/WRITE PERMISSION 

These mean that the process lacks the access required to read or 
write the segment mentioned in the error message. 

prog 

Error: no_write permission condition by progi'»12 (line 101) 
referencing >uddySerpent>PJApple>data_seg 1 2 
r , , , . level 2, . 

The simplest cause is having failed to set or obtain the necessary 
access. As with a no_execute_permission error above, the user may 
attempt to set the required access, and then restart the program. 

This problem may also be caused by bad address data. This case may be 
distinguished from a simple access error as also given above. 

NOT IN READ/EXECUTE/WRITE/CALL BRACKET 

This means that an attempt has been made to reference an inner ring 
segment. The cause is almost always bad address data. 

prog3 

Error: not_in_write_bracket condition by prog 126 (line 5) 
ref erencing^dseg 1 0 

r .... level 2, . 

The identity of the segment being referenced can often give a clue to 
the variable whose value is bad. A reference to dseg, as occurred 
here, usually indicates that a packed pointer (a pointer value 
declared unaligned) is uninitialized. A reference to the stack or 
linkage section, is strong evidence that an automatic or static, 
respectively, aligned pointer, label or entry value has not been 
assigned a value. 



FAULT TAG 1 /FAULT TAG 3 

This means that an addressing modification fault has occurred while 
attempting to indirect through a pointer. Since these modifiers never 
appear in PL/I pointer datums, the problem is usually uninitialized 
address data. 

prog 

Error: fault tag_l by >udd>Serpent>PJApple>prog 1 1 4 (line 8) 
referencing s"Eack_M 13320 (in process dir) 
Ascii data where pointer expected, 
r .... level 2 , . 



ii-20 



The fact that the program was referencing some data in stack^^l at the 
time of the error indicates that the bad pointer was an automatic 
value. If the program had been referencing "combined linkage_section 
^.00, the bad pointer would be a static value. The address modifier 
may also be encountered when trying to execute data. In such a case, 
the error message will indicate that the segment causing the error is 
a data segment such as the stack or the combined linkage section. 

The error fault_tag_1 is often caused by an uninitialized pointer 
occupying space previously filled with ASCII data (hence the second 
part of the error message). 



ILLEGAL MODIFIER 

This means that an illegal address modifier has been used. It may 
appear in a pointer value or in data being executed as regular 
instructions . 

prog 

Error: illegal__modif ier condition by >udd>Serpent>PJApple>prog I 
(Line 18) referencing stack_^|0 (in process dir) 

Possible illegal modifier in indirect chain or uninitialized pointer, 
r .... level 2, . 

The causes of this error are identical to those of a fault_tag_1 /3 
error. It is also not restartable. The problem must be corrected 
before the program can be run again. 



ATTEMPT TO REFERENCE THROUGH A NULL POINTER 

This means that a null pointer has been used as a locator value 
qualifying a reference to a based variable. It usually indicates a 
logical bug in the program. 

prog 

Error: Attempt by >udd>Serpent>PJApple>prog 1 57 (line 23) 
to reference through null pointer 
r .... level 2.. 

The programmer should carefully examine his or her program to 
determine how the locator (pointer or offset) value could have a null 
value at the location in which the error occurred. The variable may 
not be referenced with an explicit qualifier 

data instead of pi -> data 

In this case, the default qualifier e.g., based, (p) is used, and 
its value should be checked. 



probe 

Condition simfault_000001 raised at line 23 of prog, 
source 

result = based^num + M; 
symbol based num " 
fixed binaryTl7) aligned based (p) 
Declared in prog, 
value p 

null 



This error may also occur for controlled as well as based data, if a 
controlled variable is referenced before it is allocated. 



SIMFAULT NNNNNN 

This means that the programmer has attempted to use a pointer with a 
segment number of -1 and an octal offset of NNNNNN. The cause is use 
of uninitialized address data. 

Note: a pointer with segment number -1 and offset 000001 is a null 
pointer. In such a case, the error message reads "Attempt to 
reference through a null pointer" as described above. The condition 
simfault 000001 is signalled explicitly only when the pointer value is 
not entirely a valid null pointer (for example, it has a non-zero bit 
offset) . 



ILLEGAL MACHINE OPERATION 

This means that there has been an attempt to execute an undefined 
machine instruction. 

prog 

Error: Illegal machine operation by prog!^ 
Current instruction is: 

000004 000000000000 .... 0 

r .... level 2,. 

The two most common causes of this error are: branching to a 
nonexistent element of a constant label array, or using an 
uninitialized label or entry value. The segment in which the error 
occurs may be used to distinguish the two cases. In the former, the 
segment will be one of those in use (in the example above prog); in 
the later, it will be a data segment (stack or linkage section) or 
some other unexpected segment. 
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STORAGE CONDITION 



There are two causes of this error. First, the user has attempted to 
allocate more based or controlled storage than is available in the 
system area. This will be acompanied by the message that system 
storage is full. 

prog 

Error: storage condition by >udd>Serpent>PJApple>prog 1 15^ (line 52) 
System storage for based and controlled variables is full, 
system handler for error returns to command level 
r .... level 2, . 

The programmer should inspect the declaration of the variable being 
allocated. The system cannot allocate more than 262,1^^ words of 
storage for any one variable. If the variable being allocated has an 
expression for a string length or array bound, the value of those 
expressions should be checked. Often they may involve undefined 
values. If all allocations are relatively small (e.g., hundreds or 
low thousands of words) , the problem may be that the allocation is 
being repeated too many times. A check should be made for an infinite 
loop involving the allocation. 

Second, and most common, is that the stack has overflowed. This error 
will be accompanied by the message that the stack has been extended. 

prog 

Error: storage condition by >udd>Serpent>PJApple>prog ! 166 (line 58) 
Attempt to reference beyond end of stack. Stack has been extended, 
system handler for error returns to command level 
r .... level 2, . 

This error will first occur when more than 6^K words of stack space 
are required, or when a reference is made past the first 6^IK of stack. 
The stack is extended to the next il8K boundary. Depending on the 
cause for extending the stack, it may be permissible to restart the 
program with the start command. Subsequent storage conditions may 
occur if additional storage is required/referenced, and the stack will 
be extended in M8K increments up to a maximum length of 208K. Any 
attempt to use more than that will cause a fatal process error (see 
below). 

One cause of this error is that the program is recursing too deeply 
(or infinitely). This case can be verified by examining the frame 
number, the second of the two numbers in the in ready message level 
information: 

r .... level .,137 
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A value in the hundreds is a certain sign of trouble. (1) The 
cummulative automatic storage requirements for a moderately recursive 
program (or set of programs) may also be too great. The required 
storage can be determined from a compilation listing produced with the 
"-map" option (under the heading "storage requirements for the 
program"). If the storage requirements will not exceed the maximum of 
208K, it is safe to restart the program. \ 

An excessively large stack frame size may also arise if there arc 
automatic variables declared with expression I length or array bounds, 
and the expressions reference uninitialized : values. A common mistake 
is to make use of another automatic variable in such an expression 
whether or not that variable has an initial value specified. For 
example, a program containing the declaration 

declare 

array (array^dim) fixed binary, 
array^dim fixed binary automatic; 

could cause the error message appearing above. A debugging session 
might continue as follows: 

probe 

Condition storage raised at line 58 of prog, 
source 

call subr (...); 

Here probe has been used to determine where the error occurred. The 
source request shows that the error occurred while trying to call 
another subroutine. The reason that the error occurs at this point is 
that until the subroutine is called (creating a new frame for the 
subroutine) the stack is not actually extended. So the programmer 
examines the program for abnormally sized variables: 

symbol array 

fixed binary(17,0) aligned automatic dimension(7 1 902) 
Declared in prog. 

The symbol request gives the evaluated dimensions for the array, 
showing it to be extremely large. (The error could appear in the same 
fashion if the large bounds were intended.) 

Another cause is subscripting an automatic array with a value far out 
of bounds. This can be detected in PL/I programs by putting a 
subscriptrange prefix on the procedure statement. 

( subscr iptrange) : 
prog: procedure; 



(1) In fact, a value in excess of 30 to 10 is uncommon, and can 
generally be regarded as a sign of problems. 



end; 



In Fortran this can be accomplished by compiling the program with the 
"-subscr iptrange" control argument. 

fortran zzzz -table -subscriptrange 

A similar cause is a string range error; that is, the use of the 
substr builtin function with out-of-range arguments. In general, this 
is an initial position (the second argument) which is negative or far 
past the end of the string, or a length (the third or assumed 
argument) that is negative or far greater that the actual length of 
the rest of the string. This error can be trapped by recompiling the 
program with a "stringrange" prefix on the procedure statement. 

A final cause is the invocation of a function that returns a value 
with star (expression) extents. If the bounds of an array developed 
as the return argument are bad, or if a bad substr expression or 
uninitialized character varying string is returned, a storage 
condition can be raised after the called function has returned, but 
before the calling program has resumed execution. This is indicated 
by a storage condition occurring in a system segment. If this is the 
case, there will be no other information as to what user program was 
executing at the time of the error. 



OUT OF BOUNDS FAULT 

This means that a non-existent portion of a segment has been 
referenced by the program. A storage condition due to a stack 
overflow is really an out of bounds fault on the stack; as a result, 
the causes and recovery methods are similar. The most common causes 
include an out-of-range array subscript or substring reference. The 
error is particularly common when the data in question is a normal 
Fortran variable, commoned (occurring in a segment in the process 
directory), or uncommoned (occurring in the linkage section), or a 
PL/I internal static variable (occurring in the linkage section), or 
an external static variable (occurring in a segment in the process 
directory). If the segment is the program itself, it is likely that 
the program is referencing outside of the bounds of a label array or 
an internal static array that has an initial value specified but has 
never been modified. 
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ILLEGAL PROCEDURE 



This occurs when the hardware is requested to perform an illegal 
operation. The most usual cause is uninitialized decimal data. 

baddec 

Error: illegal_procedure condition by >udd>Serpent>PJApple>baddec 
(line 5) referencing stack_M 13320 (in process dir) 

f ... level 2,. 

probe 

Condition illegal^procedure raised at line 5 of baddec. 
source 

dv = dv + 1 ; 

symbol dv 

fixed decimal(7,0) aligned automatic 
Declared in baddec. 
value dv 

Error: illegal^procedure condition by arithmetic_to_ascii_| 1 12 

(>system_library_standard>bound_trace_) 

referencing pi 1_operators_! 10 

r .... level 3 , • - 

release -all 
r .... 

Here probe has been used to show the source of the line at which the 
error occurred. It contains a reference to a decimal variable. This 
is sufficient evidence to believe that the problem is uninitialized 
decimal data. Displaying the value of the variable will cause the 
same error again, confirming the diagnosis of the problem. (The 
release command, with the -all option, is used to flush execution of 
probe, suspended by the second occurrence of the error, and baddec, 
suspended by the first.) 

Other, less likely, causes of the same error are: transfering to an 
element of a label array outside of the bounds of the label array, and 
referencing uninitialized label or entry variables. In the former 
case, the location of the error will often be listed as the first line 
of the program; the line from which the coridition is signalled will 
not be available. In the latter case, the location of the error will 
usually be in some unexpected segment. 



CONVERSION 



This means that an error has occurred in the conversion of a character 
string to some other data type. This condition will occur in 
conversion to an arithmetic value if the string is not a correctly 
formed number. It will occur in conversion to a bit string if the 
source character string contains characters other that "1" or "0". 

badconv 

Error: conversion condition by >udd>Serpent>PJApple>badconv ! 22 
(line 6 onsource = "one", onchar = "o" 
Illegal character follows a numeric field, 
system handler for error returns to command level 
r .... level 2, . 

The error message gives, in addition to the location at which the 
error occurred, the values of the PL/I builtin functions, onsource and 
onchar. Onsource represents the character string being converted; 
onchar is the (first) character in the string which is invalid for the 
conversion. 

This error may arise during implicit or explicit conversions among 
variables (or the results of expressions) in the program, or during 
execution of a get statement when the input is converted to an 
arithmetic or bit value. 



SIZE 

This condition has three causes. It will occur when the value 
assigned to a fixed point datum exceeds the precision of the target — 
for example, assigning the value 9999 to a fixed binary(3) datum. The 
error will occur in this way only only if size checking was enabled 
for the statement in which the assignment was performed by a size 
prefix on the statement or the procedure statement. Second, it will 
occur during picture controlled conversion, if the target field is too 
small to hold the value being converted. Again size checking must be 
enabled. Third, it will occur during a put list or put data 
statement, when the value stored exceeds the precision declared for 
the variable, or during a put edit statement, if the output field 
cannot hold the value being output. Size checking is always enabled 
for put statements. 

size^err 

Error: size condition by >udd>Serpent>PJApple>si ze_err 1 1 36 (line 14) 
Precision of target is insufficient for number of integral 
digits assigned to it. 

System handler for error returns to command level 
r .... level 2, • 
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The user should be aware of a side effect of a size condition raised 
while executing a put statement. A common debugging technique is to 
include an error on unit within the program that dumps all the 
variables: 

on error begin; 
put data; 

end ; 

If a size condition occurred, invoking the on unit, the put data 
statement within the on unit will cause another size condition to be 
signalled when formating the variable for which the condition was 
originally signalled. The on unit will be invoked a second time, and 
the size condition signalled yet another time, and so on, ad 
infinitum, eventually leading to a storage condition or fatal process 
error. 



ERROR CONDITION 

An error condition will be reported when an erroneous state arises in 
the program, and there is no specific condition for that state. For 
example, this includes use of mathematical builtin functions with 
arguments that are out of range. 

The following program is used to illustrate a typical situation in 
which the error condition will be raised. 

bigexp: procedure; 

del sysprint file; 

put list (exp (23**5)); put skip; 

end; 

Executing the program will cause the condition to be signaled. The 

system on unit gives the rea^fon for the specific cause of the problem, 
and states a fixup to be taken if the program is restarted. 

bigexp 

Error: error condition by >udd>Serpent>PJApple>bigexp J 53 (line 3 

exp(x), X > 88.028, not allowed 
Type »'"start"" to set result = . 170141 l8e+39 
r .... level 2 , . 

start 

1.701e+038 
r . • • • 

After receiving the error, the programmer may decide that the standard 
fixup is acceptable, and restart the program as has been shown above. 
Notice that the program proceeds normally to output the result as set 
by the action of the system on unit. ~" 
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SUBSCRTPTRANGE 



This means that a subscript specified in an array reference is outside 
of the bounds of the array. The condition is normally raised only 
when the programmer has specified that subscript range checking be 
performed (by placing a subscriptrange condition prefix on a PL/I 
procedure statement, or compiling a Fortran program with the 
-subscriptrange control argument). Such checking is useful when there 
are unexplainable storage, out of bounds, or fatal process errors, 

subrange 

Error: subscriptrange condition by >udd>Serpent>PJApple>subrangeM7 
(line 7). 

A subscript value has exceeded array bounds, 
system handler for error returns to command level 
r .... level 2 , . 

probe 

Condition subscriptrange raised at line 7 of subrange, 
source 

array (i) = i; 

value i 

5 

symbol array 

fixed binary(17,0) aligned automatic dimension(it ) 
Declared in subrange. 



Above is an example of a subscriptrange condition. Upon receiving the 
error, the programmer enters probe to determine the cause of the 
problem. The source request gives the text of the lin6 on which the 
error occurred (line 7). He then displays the value of i and compares 
it with the dimensions for the array as given by the symbol request. 
Here the subscript, i, is only a little bit out of range. This 
indicates a logical bug, specifically, that the program is not 
constraining the value of the subscript properly. Alternatively, if 
the value of the subscript were grossly out of range (for example, 
-72301292), this would be an indication that the problem was that the 
subscript was uninitialized or assigned the value of some (function of 
an) uninitialized variable. 

This condition may also arise when a function which returns a 
dimension (*) array is used, and the bounds of the array returned do 
not match the bounds of the array to which it is assigned. For 
example, assume that data has dimension m) and that array^fun returns 
an array with dimension (5). Then 

data = array^fun (...); 

will cause a subscriptrange condition to be signalled. 
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STRINGRANGE 



This means that a substring of a character or bit string value as 
specified by the substr builtin function is not completely contained 
within the string value. Given the reference 

substr (s, i, J) 

the error implies that one of two conditions is true: that i, 
specifying the starting position of the substring, is less than one or 
greater than the current length of the string, or that J, specifying 
the length of the substring, is less than zero or greater than the 
^ number of positions included in that portion of the string from 
position i to the end. 

The stringrange conditio^ will only be raised if the programmer has 
compiled the program with a stringrange condition prefix on the 
procedure statement or on the statement which uses the substr built-in 
function. 

stringrange 

Error: stringrange condition by >udd>Serpent>PJApple>5tringrarige 
(line 7). A substring specified by substr is not completely 
contained in the first argument. System handler for condition 
returns to command level. 

r .... level 2,. - 
probe 

Condition stringrange raised at line 7 of stringrange. 
source 

substr (str, 1, i) = "a"; 

value i 
-1 

* * • 
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FIXEDOVERFLOW, OVERFLOW. UNDERFLOW 

These errors indicate that the result of a computation has exceeded 
the precision of the machine. Fixedoverf low applies to fixed point 
computations and indicates that the result is too large. It should 
not be restarted. 

folf 

Fixed point overflow by >udd>Serpent>PJApple>fol f 1 143 (line 27) 
System handler for error returns to command level 
r .... level 2 , . 

Overflow applies to floating point computations, and indicates that 
the result is too large. It should not be restarted. 

olf 

Error: Exponent overflow by >udd>Serpent>PJApple>olf 1 160 (line 33) 
System handler for condition returns to command level 
r .... level 2, . 

Underflow applys to floating point computations, and indicates that 
the result is too small. The program is automatically restarted with 
the result of the computation set to 0. 

unfl 

Error: Exponent underflow by >udd>Serpent>PJApple>unf 1 1 16? (line 39) 
r • . . • 

Notice that after an underflow condition the system does not enter a 
new command level, but instead continues with the program. Here it 
has terminated normally, returning to command level 1. 
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PROGRAM INTERRUPT 



The program Interrupt comtnand is used to reenter a command subsystem 
such as edm or probe after an error condition or quit signal. The 
command signals the program interrupt condition which is trapped by 
the subsystem. If the user mTstakenly issues a program interrupt 
command to reenter a subsystem that does not handle the condition, or 
when there is no subsystem active, the condition will be reported as 
an error at command level. 

program^interrupt 

Error: program_interrupt condition by program_interrupt 171 
(>system^library^standard>bound_command_env_) " • 

r .... level 2,. 

If there is no subsystem active, the user should issue a release 
command to flush the program interrupt condition. If the user is 
trying to reenter a substem That does not handle program^interrupt , he 
should issue a release command to flush the program_interrupt and then 
a start command to reenter the subsystem. (Normally, however, a 
subsystem may be reentered by a start command only if it was suspended 
by a quit signal.) 
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SECTION V 



FATAL PROCESS ERRORS 



In general, a fatal process error occurs when the system detects a 
condition such that the process is not able to continue running. (In 
particular, the system default on unit cannot be executed to interpret 
the cause of the error.) The action taken in this case is to 
terminate the process in which the error occurred and to create a new 
process for the user. Because it is a new process, there is no 
information available about the programs that were running when the 
error occurred, the value of program variables, etc. The only clue as 
to the cause of the error is the error message. 

The single most common form of a fatal process error is an out of 
bounds error on the stack. The causes are the same as for a storage 
condition (see above) arising on the stack. The message that is 
generated by the system designates that a fatal error has occurred, 
and then gives a error message indicating a more specific problem. 

Fatal error. Process has terminated. Out of bounds fault on user's 
stack. New process created. 

In the event of this kind of fatal process error, it is advisable for 
the user to recompile his program with subscriptrange and stringrange 
checking enabled and try the program again. If a stringrange or 
subscriptrange condition then occurs instead of the fatal process 
error, then it is likely that new error is the source of the problems. 

If the fatal process error recurs despite the checks enabled, then the 
cause of the problem can be just about anything. It is recomlnended 
that the user check his access to all programs and files that he is 
using to insure proper access. He should also check for the possible 
causes of a segment fault error. Finally, calls to system programs 
should be checked to see if they conform to all documented 
conventions. Should these checks fail to turn up a clue. He should 
use the probe command to set breakpoints at various strategic points 
in his program to isolate the point at which the fatal process error 
is occurring. Often the process will have to be repeated with 
additional breaks set until the location is narrowed down to a single 
statement. 
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There are several other kinds of fatal process errors that the user 
may see. They include: 

No unclaimed signal handler specified for this process. 

This means that no default on unit could be found. The 
possible causes include subscript and stringrange errors, and 
the use of uninitialized address data. (See above and the 
previous section.) 

Fault in signaller by user's process. 

This indicates the presence of a very complex error condition 
and probably involves more than one cause. The user should 
apply the methods of described for the other errors and hope 
for the best. 

Unable to perform critical I/O. 

This means that the user's process was unable to perform an 
input or output operation at a crucial point. For example, 
writing out an error message. This indicates that the I/O 
attachments for the user_input, user_output, error_output and 
user i/o I/O switches are in an untenable state. The user 
should consider the kinds of operations that he performed 
prior to the fatal error, and determine if they conformed to 
documentation. 

Process terminated because of system defined error condition. 
This is a catch all message. Again, the user should try the 
methods described above. 



The reader should recall the comments about errors that vanish after a 
new process is created made in the introductory remarks to section 
IV. They apply to a fatal process error as well. 
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THE TYMNET NETWORK 



Assignment of TYMNET user id's and passwords contact 

Lacy Johnson 
Honeywell LISD 
Multics Computer Center 
Box 6000 Mail Station K40 
Phoenix, AZ 85005 
Phone: (602) 249-7303 HVN 341-7303 



LOCAL LINES 

D) a "help TYMNET__lines" to obtain a list of TYMNET dial-up lines 
ii the major cities serviced by TYMNET. 



COST 

TjMNET charges $7.50 per connect hour which will be passed on to 
the appropriate cost center^ 
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• SUPPORTED TERMINAL 



D TYMNET supports a wide variety of terminal types. Each terminal 
type has an identifying character which must be sent to TYMNET 
when you first log in to establish the transmission 
characteristics of the terminal. 



IDENTIFIER TERMINAL REMARKS 





Speed 

(CDS 


Baud 
rate 


Type 




b 


15 


150 


TermiNet-300 
TTY-37 
Hazeltine 
Execuport 


Full Duplex, 
odd parity 


d 


10 


110 


TTY 33/35 
TermiNet-300 


Full Duplex 


a 

(RECOMMENDED) 


30 


300 


TermiNet-300 
Execuport 
Texas Inst. 
CSC 

Hazeltine CRT 


For thermal printer 
terminals, a delay 
of N+6 or 7 
character times 
is used. 


carr igae 
return 


15 


134.5 


Date] 

IBM 


Multics only accepts 
EBCDIC terminals 
through TYMNET. 



• Only 300 and 13^.5 baud lines are available on Multics for access 
through the TYMNEi network. 
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LOGGING INTO TYMNET 



1. Turn on the terminal and coupler. 



2. If the terminal has adjustable data transmission speeds, set 
the terminal to 30 cps. This is to handle TYMNET'S initial 
message. Lower settings give a garbled message during login. 

3. If you are using a terminal that has an Auto Linefeed switch 
(such as the TermiNet 300), turn it off during the initial 
login procedure with TYMNET. Once you have made contact with 
Multics you may turn it back bn. 



4. Dial the TYMNET phone number and wait for the high-pitched 
tone. (If the tone sounds weak or raspy, hang up and re-dial 
to obtain a better line). 



5. Place the telephone handset in the coupler or depress the 
"DATA" button if using a 103A or 113A dataset. 



6. The following message will be sent to your terminal at 10 
cps: PLEASE TYPE YOUR TERMINAL IDENTIFIER 

7. Set your terminal to the desired speed (if necessary), and 
type the appropriate letter or CR (carriage return). 

8. TYMNET will then send: -XXXX-YY— PLEASE LOG IN: where: 
XXXX is the remote access node number, and YY is the port on 
the node to which your terminal is connected. 



(OPTIONAL) You may check 



presence of the network 



supervisor (which controls the Tymsat you have called) by 
typing a single CR. If the supervisor is in control, the 
following prompt will appear: USER NAME: 
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10. You may need the following control characters before entering 
your user name: 

a) control-H notifies TYMNET not to echo characters 

b) control-X to be used if you plan to input data from 

paper tape, cassette tape, or any other 
non-keyboard device. TYMNET must be able to 
start and stop data entry. For this, 
control-Q starts the device and control-S 
stops the device. 



c) control-P. to be used if your terminal can only accept 

even parity. 

11. After receiving "PLEASE LOG IN:" or "USER NAME:" enter your 
TYMNET user id (preceded by control characters if necessary), 
followed by a CR. (user id may be in upper OR lower case). 

12. TYMNET will then prompt you for your password: PASSWORD: 



13. Respond by typing your password(in upper or lower case), 

followed by a CR. NOTE : If you want to eliminate the prompt 

"PASSWORD:", enter your TYMNET user id, a semi-colon( ; ) , and 

the password followed by a CR. (THIS MAY NOT WORK FOR 
NON-ASCII TERMINALS) 



14. You should then receive either a semi-colon (; ) or the 
following: P nn (which indicates the port number of the 
TYCOM connected to Multics) HOST IS ONLINE 



15. From here on, the login procedure is exactly as if you were 
dialing directly into Multics. 



16. When you logout from Multics, TYMNET will respond: 

CP DISCONNECTS DROPPED BY l^OST SYSTEM 

PLEASE LOGIN: (at this point you may hang up the phone) 
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• TYMNET PROBLEM RESPONSES 



1 . ALL PORTS BUSY 



2, BUSY TONE 



3. HOST DOWN 



U. ERROR ON PORTn 



All available Multic;3 TYMNET ports are in use 
at the transmission speed you have requested. 
Try again later or try another transmission 
speed . 

If received when dialing the TYMNET network, 
wait a few minutes and try again. If the busy 
tone persists, call the local telephone repair 
service to check if the local lines are truly 
busy or out of service. If lines are continously 
busy, but not out of service, notify the Multics 
Computer Center. 

Indicates the Multics system is not in operation 
Wait and try later or contact the Multics 
Computer Center. 

System is operational, but a specific port 

or channel is not answering. Notify the Multics 

Computer Center. 



ft To report trouble call the Multics Computer Center - (602)2^9-77 
or HVN 341-7567 
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TYMNET TELEPHONE NUMBERS 



FLORIDA 

Fort Lauderdal 

Jacksonville 

Miami 

Orlando 

Pensacola 

Tampa 

St. Petesburg 
W.Palm Beach 



5 305/467-7550 
904/721-8100 
305/374-7120 
305/841-6850 
904/434-5514 
813/229-0981 
813/536-7823 
305/622-2871 



ALABAMA 

Birmingham 

ARIZONA 
Phoenix 

ARKANSAS 

Little Rock 

CALIFORNIA 
Alhambra 
El Segundo 
Los Angles 
Los Angles 
Mountain View 
Mountain View 
Newport Beach 
Oakland 
Oxnard 
Palo Alto 
Riverside 
Sacramento 
San Clemente 
San Diego 
San Francisco 
San Jose 
Santa Bc.rbara 
Santa Rosa 
Van Nuyr. 



CONNECTICUT 
Bridgeport 
Danbur y 
Dar ien 
Hartford 
New Haven 
Waterbur y 

DELAWARE 
Wi Imington 



205/942-4141 



602/249-9261 



501/372-5780 



213/572-0999 
213/640-1570 
213/629-1561 
213/683-0451 
415/961-7970 
415/941-8450 
714/540-9560 
415/465-7000 
805/487-0482 
415/326-7015 
714/325-9372 
916/441-6550 
714/498-3130 
714/291-8700 
415/391-9325 
408/984-5500 
805/966-3184 
707/526-2180 
213/986-9503 



203/579-7820 
203/792-3060 

203/655-8931 
203/568-2610 
203/787-5974 
203/757-2537 



302/658-5261 



GEORGIA 
Atlanta 

HAWAII 
Honolulu 

IDAHO 
Boise 

ILLINOIS 
Chicar^o 
Chicago 
F^eeport 

Freeport 

Rockford 

INDIANA 

Fort Wayne 
Indianapolis 
Marion 
Southbend 

IOWA 

Cedar Rapids 
Des Moines 
Iowa city 

KANSAS 
Topeka 
Wichita 

KENTUCKY 
Louisville 

LOUISIAUA 
Baton Rouge 
Lafayette 



404/659-6670 



808/521-7481 



208/343 -4851 



312/346-4961 
312/368-4607 
815/232-2181 

(30 cps) 
815/233-2186 

(10 cps) 
815/398-6090 



219/424-5162 
317/257-3461 
317/662-0091 
219/259-9941 



319/364-3371 
515/280-9600 
319/351-4046 



913/233-1612 
316/265 -1241 



502/361-3881 



504/927-6400 
318/235-5202 



DISTRICT OF COLUMBIA 

Washington 703/341-0200 
Washington 703/84 1 -.9560 



COLORADO 

Colorado Springs303/47 1 -981 5 
Denver 303/458-7921 
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New Orleans 



MARYLAND 
Annapolis 
Baltimore 

1ASSACHUSETTS 
Boston 
Boston 
Cambridge 

IICHIGAN 
Ann A^^bor 
Detroit 
Jackson 
Kalamazoo 
Southf ield 
St. Joseph 

INNESOTA 
Minneapolis 

ISSOURI 
Kansas City 
St. Louis 

EBRASKA 
Omaha 

EVADA 
Carson City 
Las Vegas 

EW HAMPSHIRE 
Nashua 

EW JERSEY 
Englewood Cliff 
Moorestown 
P iscataway 
Princeton 
Wayne 
Union 

:W YORK 
Albany 
Buffalo 
Corning 



504/586-1071 



301/268-9290 
301/547-3100 



617/964-3925 
617/964-3900 
617/491-5476 



313/665-2627 
313/963-3388 
517/784-8522 
616/385-3150 
313/355-2950 
616/429-2568 



612/854-6659 



816/753-6620 
314/421-5110 



402/329-2970 



702/882-7810 
702/386-1899 



603/888-3354 



201/894-8250 
609/235-3761 
.'11/981 -0370 
609/452-8228 
201/785-4480 
201/964-6300 



518/463-31 11 
716/856-1400 

607/962-5071 



Huntington, L 
New York City 
New York City 
New York City 
Niagra Falls 
Rochester 
Syracuse 
White Plains 

NORTH CAROLINA 
Charlotte 
Durham 

OHIO 
Akron 

Cincinnati 

Cleveland 

Columbus 

Dayton 

Toledo 

OKLAHOMA 

Oklahoma City 
Tulsa 
Tulsa 
Tulsa 

OREGON 
Portland 

PENNSYLVANIA 
Allen ^.own 
Erie 

Erie 

Harrisburg 
Philadelphia 
Pittsburgh 
Valley Forge 
York 

RHODE ISLAND 
Providence 

SOUTH CAROLINA 
Greenville 

TENNESSEE 
Memphis 



1.516/673-5780 
212/350-9100 
212/551-9322 
212/344-7445 
716/285-9354 
716/546-1410 
315/437-7111 
914/761-8449 



704/376-0320 
919/549-0441 



216/535-1861 

(30 cps) 
513/242-7040 
216/781-7050 
614/421-7270 
513/223-3847 
419/243-3144 



405/947-0561 
918/492-5306 
918/492-1687 
918/663-2220 



503/224-0750 



215/433-6131 
814/725-8671 
814/454-6467 
717/236-1 190 
215/561-6120 
412/765-1320 
215/666-9190 
717/846-4802 



401/351-2920 



803/271-2418 



901/345-1111 



F01 



TYMNET TELEPHONE NUMBERS 



TEXAS 
Austin 
Baytown 
Beaumont 
Dallas 
El Paso 
Ft. Worth 
Houston 
Houston 
Houston 
Longv iew 
Lubbock 
Midland 
Odessa 
San Antonic 

UTAH 

Salt Lake ( ity 

VIRGINIA 
Norfolk 
Richmond 

WASHINGTON 
Seattle 

WISCONSIN 
Madison 
Milwaukee 
Oshkosh 



512/444. 

713/427 

713/832- 

214/638- 
915/544 

214/263 

713/785- 

713/785 

713/780- 

214/758 

806/762- 

915/683 

915/563- 

512/734 



•3280 
■1 123 
'2589 
•5800 
■9590 
•2341 
■4420 
4411 
•7390 
■0801 
■2402 
•5645 
•0273 
•7^81 



801/582-8972 



804/622-0435 
804/649-3050 



206/622-7930 



608/221-421 1 
414/257-3482 
414/235-4594 



BELGIUM 
Brussels 
Contact E.. 
233-3700 

CANADA 
Calgary 

Calgary 

Calgary 

Edmonton 
Montreal 



Godhaird 



403/263-7301 
(30 cps) 

403/263-2006 
(14.8 cps) 

403/263-2072 
(10 cps) 

403/423-4888 

514/878-0584 



Montreal 

Montrsial 

Ottawa 

Toronto 
Vancouver 

Vancouver 

Vancouver 



(30 cps) 
515/878-0589 

(14.8 cps) 
514/878-0588 

(10 CDS) 

613/563-9841 

(30 cps) 
416/863-6202 
604/688-981 1 

(30 cps) 
604/688-4838 

(14.8 cps) 
604/688-4338 

(10 cps) 



ENGLAND 

Conta<it Allen Jenkins at 
01-606-4671 or 01-432-5573 
for further details to use 
the Data Base Service of the 
British Post Office. 



FRANCE 
PARIS 

Contact Mr. Feuvrier 
DTRI 

246 RUE DE BERCY 

PARIS CEDEX 12 75584 

(All France is "Toll Free" 

to TYMNET Nodes) 
346-12-55 EXT. 4331 
TELEX: 670372 



GERMANY 
FRANKFURT 

Contact Mr. Helmuth Wolf 
(611) .211.33.20 



HOLLAND 

AMSTE^^DAM 

Contact Mr. V. Moorsel 
070-753652 

MEXICO 
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MEXICO CITY 

Contact Mr. Rafael Rivera 
of CONACYT 
905/52^-7365 



NETHERLANDS 
The Hague ^6-97-61 

^UERTO RICO 
SAN JUAN 

Contact Ar , Ed Lukas 
724-3989 . 

>PAIN 
MADRID 

Contact Mr. Jaime Carvana 

248-8531 
.WITZERLAND 
BERNE 

Contact Mr. Urs Loosli 

022-28-7 117 

(All Switzerland is 

"Toll Free" to TYMNET Nodes 
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CRF 
b :pwl 
: wta_ad 

Dirs 
Segs 
GRT 

cc ns 

FOREDW 

FORDAK 

FORRRR 

-dtm 

-dtu 

-master 

bob 

E 

JUNK 
ME 

-Wd 

racx 
am 

DEFER 
no 

rest 
yes 



"-ds CRF_cabinet" 

"cwl &1; twl &1; pwl &1; dl &1 .wl" 

"tape_arjsi_ 1 -create -name sample -number 1 -format db 
-expires 12/31/99 -density 800 -ring" 

([dirs *»]) 

([segs »»]) 

-ctl "p'^a "a^a v'^.Sf r ^ . 3f m'^ . 3f b'^d d'^d $".2^^/" -date 

-hou^ -min -vt -rt -mut -pgt -$t 

-dev user_i/o -dim syn 

-ds "FOR Wallman" -he "AT PCD" 

-ds "KAYDEN: CISL" -he "Cambridge MA" 

-ds "STA-D DVP" -he "RON RIEDESEL" 

-dtcn -sort dtcm 

-dtu -sort dtu 

-in 15 -dv dtc300s -hyph 

Alvarado 

[home__dir]>exl 

[pd]> junk_ 

[user name] 

[wdj 

ac X ([segs **.arohive]) 
accept_messages ; memo -on 

am -hold -call "do ""ec >udd>m>lls>ec>me 5s_handler 
defer &f1""";gr -set -call "print_messa{^es" 

answt r no -brief 

answer rest 

answer yes -brief 
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b xpl1 
: ale 

b sysup 

b ivt 
b unmask 

athvn 
b cl 
b cispn 

ro 

mnth 
b rtape 



b wtape 



b cpa 
U 

b LSOLD 



asr >exl>o -before >sss 

asr >udd>Demo>dbm_test>linus>executable 
working dir 



-after 



calc " (page_f ault_histogram 1 pf h . last_pf_time) ~ 

(disk_traffic_dataI2,d)/6000000" 

calc "(tc_data| 400+apte . virtual_cpu_time)/60000000" 
call hcs_$set_ips_mask -o -2 -r -o 0 
can be reached at 703-790-3213, hvn 231 
cf -a; rl -a 



check_info segs ~pn 
>doc>inf o>'* . info -pn 
>exl>info>** - info 

ro; am -pr -bf; rdy 

comp monthly -in 10 
[month name] -pass 2 



>doc>iml_inf o>** . info -pn 
>udd>m>lib>inf o>** . inf o -pn 



of [month name]. report -pm 



copy_file ids [string tape_ibm_ [response "tape 
name:"] -nb [response "file number on tape:"] -bk 
[response "block length:"] --rec [response "rec 
length:"] -fmt fb -mode [response "ascii or ebcdic:"] 
-den [response "density:"] -no_labels -retain all] -ods 
[string record stream_ -target vfile_ [response 
"segment name;"]T 

copy_file -ods [string tape_ibm_ [response "tape 
name:"] -nb [response "file number on tape:"] -bk 
[response "block length."] -rec [response "rec 
length:"] -fmt fb -ring -cr -mode [response "ascLi or 
ebcdic:"] -den 1600 -no_labels -retain all] -ids 
[string record_stream_ -target vfile_ [response 
"segment name:"]] 

cpa -minlines 1 minchars 2 

cwd < 

cwd >udd>m>tac>s ; in ls;tmr ls;dn Is In lt;an working_ls 
Is m It 



b return 



cwd [value old dir]; pwd 
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cwd; cwd 

cwd;fo tape_list ; tapac tl cdt;ro;dp -dl tape_list 
cwd ; pwd 

date_time ; ioa_ [string "USER ID " [user name] 

[user project]];ioa $nnl "TERMINAL NUMBER ";u3er 
device channel; ioa Tstring [system n_users] USERS ON 
SYSTEMI 

dd -force 

defer_messages; memo -off 

df p>new_games -bf;fo p>new_games ; do "ioa_ &1;lsd &1 -a 
-sort" ([contents p>gamelist ] ) ; ro ; cpa p>raaster_games 
p>new_games ; dl p>master_games ; rn p>new_garaes 

raaster_games 

dl [pd]>stack_4 

dffl;a *hold -ciill do ""sms [1ms] Messages Deferred.""" 

do "answer yes -bf move test>&1 . runout save>==" 

do "comp &1.info -of &1.info -gl;an 

&1 . info .compout &1.info; dn &1 . inf o . compout" 

do "ioa &1;cpa save>&1 test>&1 5 1" ([segs 

test>*»]) 



do " answer no -bf cr &1.p; tc &1.p; fo &1.p; profile 
&1; ro" 

do " rdn; gr -control ""'^/Yes Master??"/"" -set -call 
pm" 

do " set_tty -ttp vip7200 -modes 

echoplex , 1180 , "ctl_char ,polite,replay,&f1" 

do "&1 ([segs &2])" 

do "&1 [directory &2]>([files &2]) &f3" 
do "&qri" 

do "(cd cwd) [entry &1];cp -acl &1>** ==;cwd <;sbc 
[entry &1 ] &2" 

do ". call hcs_ $make_ptr -111 &1 &2 -r -111 -r -o 0" 
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b lst_ 

b cr 
b rf 
b pcd 

b macabsl 

b find 
b sval 

b valu 
b gpi 

b listprog 
b IPSstaff 

b rui 



def 
4 

2 



b WEEKLY 

b PLI 
b COMP 
b ; c Lspn 



do ". call lib_sort_tree_$by_pr imar y_name -p &1 ~p &2 

-p &3 -P 

do create &1 ; if arg &2 -then ""addname &f1""" 

do dm;rf &f1;ioa_ "3/Done.;am -short -print" 

do if arg &1 -then "". pcd <\f1"" -else pcd mem 

cpu i^age 



II It II 



do if argeq true [exists segment &1.absout] -then 
""truncate &1.absout""; ear &1 -rt -q 1 ~ag [spe &1 ] 
[suffix &1]" 

do ". in &1; Irn &1" 

do ioa """a: '''a' changed to •'^a'"" &1 [string 

[value &1]T &r2; value$set &1 &r2" 

do ". ioa_ [string [value &1]]" 

do ". ioa_ '^a [gpn &2.1" 

do list -nm -all -bf -sort nm &1.»*" 

do ". memo -al -time ""1245. &1"" &2 [substr [day_name 
&1] 1 3]"" 1300: IPS Staff Meeting""" 

do ". on cleanup im -brief ""dm; runoff &rf1; im; 
ioa_$nnl """ 

do ".abf :rd do "":r 

do " .af : :comp &1 " 

do ".af : :pll &1" 



do 



.l";ioa 



;ws >udd>m>lls ''Is -all -sort dtu 



-mode -length -name -dtem -dtu"; do 
>udd>m>lls>ec>&1 " ([segs >udd>m>lls>ec>*» J ) 



loa 



do ":2 [spe Scl pl1];LK &1 list pl1;UL &1 pl1;pl1 &1 
-map &f2;:3 [spe &1 pi 1 ] . list ;SEVERITY pll &1 " 

do ";4 [spe al compin];LK &1 compout compin;comp &fl 
-of;:3 [spe &1 compin] . compout" 

do ":lf 4; ws &1 ""cis -pn [wd]>*» -dt [default [value 
doc changes date] &2] &3 &4 &5 &6 &7 &8 &9""" 
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do '':par &1;ear [ home_dir ] >&1 -tm [response ""What 
time?""] -ag do Lwd] &fr2" 

do ">udd>m>ab> value$set dir [wd] -cm ""Set by the zap 
abbrev"" ; new_proc" 

do "ABSUT1 &1 &r3;ear ME>&1 -rt -q [default "2" &4] -of 
pooldir>&1 .absout -bf -ag &1 &2 [fl 'tw-^a"" &5 &&] 
&r3;lar -position -q [default "2" &4]" 

[>udd>m>rab>new>abs_date] [wd] 

do "C [sysn] / [sysm]" 

do "HEY : : sm &rf 1" 

do "HEY [1ms] &rf 1" 

do "ac xf &1 [pd]>[entry &2];if is [pd]>[entry &2] 
-then ""compare [pd]>[entry &2] &2 &3 &4;dl [pd]>[entry 
&2]""" 

do "add_narae &1 &!; delete_name [directory &1]>([name 
&1 2]); '^ename [directory &1]>[name &1 11] &2; 
add_name [directory &1J>&2 [name 5c1]; delete_name 
[directory &1]>&!" 

do "am -print ; send_message &f1" 

do "answer no mail >udd>&2>&1 >&1 " 

do "answer no -bf &f1" 

do "calendar &1/01 -fw holidays birthdays" 
do "cd &1 ;SIS &1 ;SID &1 " 

do "comp psr.[substr &1 1 3] &f2 -pm ""&1, 1978"" " 
[month_name [response "Month No? (1-1 2)"] /I] 

do "compare &2>&1 &3>&1 " ([index_set 0 [response "Last 
comp_no?" ] ] ) 

do "cpa &1 <(old new)>==" 

do "create_dir &1;(sis sid) &1 (rew sma) [user 
name]; (sis sid) &1 (re s) *;da &1 [user name], [user 
project];sa &1 (sma s) ([user name]. [user project] *)" 

do "create_wordlist &1 ; tr im_wordlist &1.wl; 

printwordlist &1 .wl" 
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b yet, 

b cig, 
b setre 

= dla 
b REFRESH 

b qxab 



b comp 
b rrfdtm 

b filexist 

b : d pn t 

b dofa 

b ADDTIME 
b fout 

= dsrc 

b ,,log 

b CALENDAR 



do "cwd;if [less [value Time] [time]] -then ""ioa_ 
YES!!"" -else ""ioa_ No.'^x[value Time]"";cwd &1" [wd] 

do "cwd ; value$set Time [time 30 min];cwd &1" [wd] 

do "da &1 ..;sa &1 re da &1 * . SysDaemon . *" 

do "dl &1.(absin absout)" 

do "ill [j)d]>[entry &1 ] -bf;mv &1 [pd]>[entry &l];mv 
[pd] >[entry &1 ] &1" 

do ".11 [pd]>abr -bf;fo [pd]>abr;if arg &2 -then ""do 



ft ft II It 



.u &^ 



} tt It It ft ti It 



; do 



.1 &q1"";do "".u"";ro;if isnzf 



[pd]>abr -then ""qxr [pd]>abr Is/'^/e.a/ s/ '^e . ab*/& if / 
1 pint I 

do " Im; cc>mpose &f1; am" 

do "'Im; memo -off;rf &1 -pm [string [year] [month__name] 
[day! at [time]] &f2;im;memo -on" 

do "'lo ""if [exists segment &&r! -then -else """"ioa 
4& 111. II It II H ([contents &1])" 

do 'dp -ds ""MAY, CABINET"" -he [string [default 
[upp.ir_case [entry &1]] &r2]] -q [default 3 &3] -ned 
&f4 i1" 

do ";^a &1 &2 ""push_wdir [if [ngreater [index [status 
-tp ti] directory] 0 ] -then &1 -else [directory &1]]; 
&3 &'-f4; pop_wdir""" 

do " o &1.List;ioa_ " Ti/ ; pi 1 $times ; ro" 

do " o &1 ; Lo detach error_output ; io attach error_output 
syn_ user_output" 

do "10 =cp>+src .&1 . list ;ds [=gtt>aft *src] -ch;ro;ioa 
""+SIC.&1. list Created.""" 



It f 



>udd>m>ejw> [month namej.log time; ioa $nnl 



do 

[dati_time]; ro" 

do "fo CPS>calendar ; calendar [date] -fw 

HDS>i >holidays;do ""calendar """"&&1 month"""" -fw 
HDS>i >holiiays"" ([index_set 12]);ro;DPDL CPS>calendar 
&f 1" 
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do "if [and [not [exists segment &1.ec]] [exists 
segment &l.absin]] -then ""an &1.absin &1 .ec;exec_com 
&f1"" -else ""exec_com &f1""" 

do "if [equal &n 0] -then ""ps usage: Usa^^^e is: 
usage"" -else ""ps usage: Wrong number of arguments 
supplied. For usage insti^uctions , type 

tt II It ti 3g g II It n It n ti II 

do "if [exists argument &1] -then ""release -all"" 
-else ""release""" 

do "if [greater [status &1.pll -dtcm] [status &1 
-dtcm]] -then ""ps &1 has been modified""" 

do "if [have_mail] -then ""mail &rf1"" -else ""do 
>udd>m>vv>basement>say ; logout &rf 1 """ 

do "if [or [equal [format_line "a 

[last_mei;sage_sender] ] [user name]] [equal [string 
[sutstr I last_message] 1 10]] Acknowledg]] -then -else 
""sns [ last_message_sender ] """"(Answering 

service):"""" &f1»»"" 

do "am;srii &1 &2;dm" 

do "ind -Im 3 -in 2 &f2" 

do "ind &1.inGl; if [query Bad?] -then ""do '»""":r 
[pd]>&1 . :.ncl.ind""""""" 

do "io attach junk discard_ io open junk s6;io detach 
error_output ; io attach error output syn_ junk ; deoiness" 

do "io ilose junk;io detaoh (junk error_output) ; io 
attach error_output syn_ user_i/o ; reomess" 

do "io_call attach &1 syn_ &;?" 

do "ioa_ ""NOT TED""; do ""&n &rf2""" 

do "ioa_ ""I WILL BE AWAY ':IL &1 - LOG ME OUT IF YOU 
NEED THE TERMINAL"" " 

do "link (&f1) [home_dir]>hh>==" 

do "list [where &1 ] &rf2" 

do "Is -nhe -first [default I &1]" 

do "mail >udd>&2>&1 >&1 &f3" 
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b bday 

b :pl1 
b :lo 

b P 
b prf 
b :dpx 

b : pxa 
b =exc 
b vip 

b reply 
b w 

b ddl 
dpi 
b Iv 
b RDN 

b linus? 
b lOCD 
b speak 

= edl 
= er .'o3 



do "memo -alarm -repeat 12raonths -date ""&f3"" &1 &2 ' s 
birthday!" 

CO "pll &1 -table -symbols &f2;ioa_ Done." 

CO "pmotd; if [have_mail3 -then ""if [query MAIL?] 
-then Htififtmail""""""; logout &1 &2" 

do "pr &1 1 9" 

di) "print &1. runout 1 " 

do "px &1 -sm :cp>[entry &1].px; dp -ds ""MAY, 
CABINET"" -he [string [default [upper_case [entry 
&1].px3 &r2]] -q [default 3 &3] -ned -dl &f4 :cp>[entry 
&1].px" 

do "px &!!** -sm :cp>[entry &1 3 .archive. px &f2" 
do "rn &1 !!!!;rn &2 &l;rn !!!! &2" 

do "set_tty -ttp vip7200 -modes 

echoplex ,1180 , polite, replay ,&fl " 

do "sm [nraf_last_sender3 &f1" 

downlog memo -al -tm [minus [system next_down_time] .13 
-call LOGOUT// 

dp -dl 

dp -dl [segs **.li;;t3 
general_ready -control '^a*/ -level; 

gr -string [substr [string [system installation_id] ] 1 
13 -date_time -level -set -call pm;dm;memo -on;rdn 

help -pn >udd>Demo>dbmt>x>doc>( linus linus_pre__release) 

io (close detach) 

io (close detach) user_output ; io attach user_output 
syn_ user_i/o 

io attach efo_ discard ; io detach error__output ; io 
attach error_output syn__ e7o_ 



io_call attach 
[hon.e_dir 3>error .msgs 
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io call open fileO(3 4 5 9); io call position fileO(3 4 
5^) bof 

ioa_ " 0.1.2.3.4 

5 .6 .7 . 8 . 9 . 

0" 

ioa_ "(users ''a: "a) (units "a: "a)" [system n_users] 

[system max usep!> ] [system n units] [system max units] 

ioa_ "Schedu led shutdown: "a " [system 

next_down_date] I system next_down_time] 

ioa_ ""5/From: '^-"a. '^a'/To: "-Whom It May Concern"/" 
[user name] [user project]; Ike -time 60 -gr 3 -spw 
[value pass] 

Ike -gr 5 -nol 

logout -hold 

mail * 

mail -brief 



stty -delay 0,0,0,0,0,0 

stty -modes tabs, 111 18, replay, polite;tab_set 
stty -ttp rosy -modes "echoplex , 11 1 30 

stty -ttp tn300 -modes tabs , 11 1 3'^ , vertsp -delay 
0, .18,0,0,0,59 

who -absentee 

who .VPI1 .VPI2 .VPI3 .VPI3 .VPI4 .VPI5 
who LMullen 

ws [hd] "sa ([segs *]) re *.».*;sa ([segs ».».»*]) r 
«.».*;sa ([dirs *»]) s ».».»;sid [wd] s ».».*;sis [wd] 
re *.».»" 

ws [wd] "da ([segs »»] [dirs *»]) ».».»;did ([dirs »*]) 
».».»;dis ([dirs *»]) ».».»" 
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WORKiiHOP ONE 



NOTE: Because these worksiiops build upon one-another, you should 
follow the instructior'S precisely, using the names indicated. 

Throughout these workshops, the Person_id "Student_??" is 
intended to mean your own Person_id. 



1. Refer to the section "Access Sequence" in topic 2, and log in to 
Multics. 

2. Exercise the delete character (#) and the delete line (@) 
symbols. For example, type the following how_many_user commands: 

hmu 

hnu##mu 

jmu§hmj T###u TSmith 



3. Type the following commands and observe the results. Supply the 
answer "yes", "no", or "rest" when asked. 

help hmu 

help sked 

help help 

4. Enter the accept_messa£,es mode by typing "am". Note that the 
accept_messages command created a mailbox for you. This mailbox 
is now a permanent part of your file space. You can now receive 
messages. 

List the names of all i.egments (files) that belong to you (Is). 
Note that your mailbox is the only segment you have. 
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Type the following sequence of who commands and observe the 
results of each form. 

who 

who .F01 

who .F01 -long 

who Student_04 

These are the names and projects of users who are currently 
logged in. Note your own "name". 



Select two or three FOl users who are currently logged in and 
send them messages. For example, the following commands will 
send messages to Student_OM and Student 09: 



sm Student_04 .F01 Does this really work? 
sm Student 09.F01 Great class, isn't it? 



Send yourself a message. 



sm Student ?? .FOl From me to you! 



Enter the def er_messages mode (dm) and again send yourself a 
message. Note that you did not receive the message as you did 
before. The messtige is in your mailbox and will remain there 
until you print_mossages . Print the message(s) in your mailbox 
(pm). 



Again, send yourse.'.f a message. As before the message was placed 
in your mailbox bec^ause you are still in the def er_messages mode. 
Return to the acc(;pt_messages mode (nm). You will now receive 
messages immediately, as they are sent. Note that the 
accept_messages command did not print messages currently in your 
mailbox. Print the message(s) in your mailbox. 
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10. Determine the current system configuration by typing the 
following print_conf iguration_deck commands: 

pcd cpu mem 
pcd 

11. Type the following sequence of commands: 

date 

date_tirae 

long_date 

time 

minute 

hour 

day 

day_name 
month 



month_name 
year 



While available in this form, these commands will take on more 
.lignif icance when the topic of "Active Functions" is discussed. 



12. Generate your resource usage report for this billing period by 
typing the resource_usage command (ru). 

Note: Your current login session may not be reflected, however, 
if other F01 classes have been conducted this month, you 
may see considerable usage. 

J. Log out (lot.out) and return to the classroom. 
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Log into Multics. Accept messages (am) and print messages (pm) 
if desired. List the riames of all segments (files) that belong 
to you (Is). Note that you still have only one segment, your 
mailbox. 



Invoke the qedx text editor (qx). Do not expect a ready_message 
as you are now in the qedx subsystem. 

You ire in the edit mode of qedx and have an empty buffer (a 
scratch-pad). Entor the append mode (a) end type the following 
threi lines exactly as you see them: 

In anything att all, perfection es attained 
when there is no longer anything to take away. 
l,2p 



Return to the edit mode (\f) and print the contents of your 
buffer (1 ,$p) . 



Correct the intentional typing errors, as well as any you may 
have made. For example, to change "es" in the first line to 
"is", type the sequence: 



1p (positions you to the first line and prints it) 

s/es/i:i/ (substitutes all "es" strings for "is") 
p (prints the current line) 

To remove the last line, type the following: 

$p (positions you to the last line and prints it) 

d (deletes the current line) 



After correcting all of the errors, write the contents of your 
buffer to a segment by the name of seg 1 (w seg 1 ) . 



Quit the editor (q) and note the ready message. You are now back 

at command level. Your qedx buffer has been destroyed. (Don't 

confuse your qedx buffer with the permanent storage system 
segment seg 1 ) 



List the names of all segments that belong to you (Is). Note 
that seg_1 was created for you by qedx's "w" request. 



W-5 



F01 



^^^^ .^^PAT^ 



9. Invoke qedx. You again have an empty buffer. (Confirm this by 
printing the contents of your buffer.) Read the contents of 
seg_1 into your buffer (r seg_1 ) and again print the buffer's 
contents. 

10. Append the following text between the first and second line of 
your buffer by typing the following requests: 



1p 
a 



not when there is no longer y^J^thing to add, but 




11. Return to the edit mo 

buffer. Correct any typing errors. 



and print the contents of your 



12. Write the contents of your buffer to seg_1 again. This write 
will replace the old contents of seg_1 with the contents of your 
buffer. 



13- Print the contents of your buffer. Note that ths. above write did 
not affect the bufj'er's contents. Write the contents of your 
buffer to seg_2 (juit for fun). The contents of seg_1 and seg_2 
are now identical. 



WORKSKOP 2 CONTINUED ON NEXT 
PAGE 
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1^. Type the following sequence of qedx requests in exactly the 
order as shown: 



/ , $s/^/zzzf/ 
/ ,$P 

g sm Student_?? .F01 
1 , $s/zzz// 

1,$P 

w 

/is/ . 
/is/ 
/is/ 
/is/ 
1 ,$d 
1 ,$p 
r seg_ 1 
r seg_1 
w seg_1 
r seg_2 
1 ,$p 
w 

5,$d 

1r seg_1 

1,$P 



Can I do this within qedx? 

(To which segment did you write?) 

(Notice the wrap-around) 
(Why is your buffer empty?) 
(Remember the default address here?) 

(Why has qedx forgotten the pathname?) 
(We're forcing the read address) 



15. Quit the editor. Note that qedx allowed you to quit even 
though you had not written out your modified buffer 
(Hsssssss ! ) . 



16 



Print seg 1 (pi* seg 1). It's contents should be 



seg 1 



In anything at all, perfection is attained 

not when there is no longer anything to add, but 

when there is no longer anything to take away. 

In anything at all, perfection is attained 

not when there is no longer anything to add, but 

when there is no longer anything to take away. 



17. List the names of your segments and log out. 
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1. Log in. Accept and print messages if desired. Execute the 
print^wdir command (pwd). This is your home directory and is 
currently your working directory. 



2. List the names of the segments in your working directory. 



3. Print the contents of your seg_1 segment (pr seg 1). 



4. Create a segment by the name of Prince (cr Prince). List again 
the names of the segments in your working directory. Note that 
Prince has a length of zero records (i.e.: it is empty) 



3. List names of all entries in your working directory (Is -all). 
Note that you have no subordinate directories. 



6. Create a :;ubordinate directory by the name of Programs 
( cd Programs). List again the names of all entries in your 
working directory. 



7. Chan.'^e your working directory to Programs (cwd Programs). Verify 
the change by printing your working directory. 



8. List the names of the segments in your working directory. Note, 
of course, that your Programs directory is empty. 



9. Without changing your working directory, print the contents of 
your seg_l segment located in your home directory 
(pr >udd>F01 >Student_??>seg_1 ) . What would (pr seg_1 ) have done? 
Try it. 



10. Return to your home directory (cwd). Why is no pathname required 
for the cwd command in this case? Verify that you are back in 
your home directory. 



11. Change your working directory to Student_01's home directory 
(cwd >udd>F01 >Student_01 ) and verify this change by printing your 
working directory. What would the command "cwd Student_01" have 
done? If you're not sure, return to your home directory and try 
it, but remember tC' change back to Student_01's home directory 
before continuing the workshop. 
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12. List the names of the segments in your working directory. 
Understand that this is Student_01's home directory. You are 
able to list the names of his segments only because he has 
granted you access to do so. Note that you have recjd permissions 
on many of Student_01*s segments. 



13. Print the contents of Student_01*s treasure_hu.it se[;ment and obey 
ull instructions specified. You are able to print the contents 
of this segment only because Student_01 has gr.tnted you access to 
do so . 



14. Change your v^orking directory to the systen's root directory 
(cwd >). Verify by printing your working directory. List all 
directories under the root (Is -d) . These are the system level 
directories. Note that they are primarily system libraries. 



Feel free to explore — time permitting. 

15. Return to your home directory and execute the following commands: 

cr X (create) 

Is X (list) 

dl X (delete) 

Is X (list) 

dl >udd>F01 >St'jden _01 >treasure_hunt (delete) 

Why were you unable to delete Student_01's treasure_hunt segment? 

cd X (create_dir) 

Is X (list) 

Recall that by default, the list command only deals with 
segments. 

Is X »d (list) 

dd X (delete dir) 



16. Add the names s_1 , sT and sl.compin to your seg_1 segment 
(an seg_1 s_1 si sl.compin). List the contents of your working 
directory. Notice how the alternate names are listed. 
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17. Print the contents of seg_1 using one of the alternate names 
(pr si). Get the status of seg_1 using another alternate name 
(st s_1 ) . Compose the contents of seg_1 one using the name 
sl.compin (comp sl.compin). Note the full-page formatting done 
by the compose command. 

18. Dei^'te the se gment seg_2 (dl seg__2). List the contents of your 
working diretitory. Notice the change in the segment count. 
Attempt to print S('g_2. 



19. Delete the names seg_1 , s_1 , sl.compin (dn seg_1 s_1 sl.compin). 
List the contents of your working directory. Notice that the 
segment count is unchanged. 



20. Rename the segment s1 to seg_1 (rn si seg_1 ) . List the segment 
seg 1 (Is seg 1) and observe the add names. 



21. Rename seg_1 to Prince (rn seg__1 Prince). Answer "yes" to delete 
the original Prince segment. (Recall that it is empty and is of 
no practical use to you.) 



22. Attempt to delete the name Prince (dn Prince). Since this is the 
only name on the segment, the command will inform you that 
deleting the only name on a segment is not allowed. 



23. Copy the segment >udd>F01 >Student_01 >alphabet into your working 
directory (copy >udd>F01 >Student_01 >alphabet ) . List the contents 
of your workinii directory and print the contents of this copied 
segment . 

Why does your oopy also have the name alphabet? What would the 
copy command Look like if alphabet was to be copied and called 
my_alphabet? 
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Log in. Accept and print messages if desired. Print your 
working directory. 

Change your working directory to >udd>F01 >Student_01 . Execute 
the following commands: 

seg_l alphabet 

ils».»» 

Vs*,* -exclude s*.* 



!urn to your home directory and execute the following sequence 
commands: (Note: If the printer queues are near empty, you 
£\y not be able to cancel some of your dprint requests) 

Idr ( list_daemon_requests) 

dp Prince (dprint) 

dp -q ^ Prince (dprint) 

Idr ( list_daemon_requests) 

Idr -all ( list_daemon_requests) 

cdr -q 4 Prince ( cancel_daemon_request ) 

Idr -all ( list_deamon_requests) 

cdr Prince ( cancel_daemon_request) 

Idr ( list_daemon__requests) 

Note how some of these commands reported the total number of 
requests (system wide) as well as your total number, but only for 
the specified queue. 

\ / 

•^ ^f tfc ^ere is an on-line printer accessible to you, dprint (for 
k\ei/s) the contents of your Prince segment (dp Prince). Do you 
reVall what the default heading and destination banners will be? 
Re^)Bmber to pick up this output sometime before class tomorrow 
nyor n^ ng . 



Enter the abbrev mode (ab) and type some command, such as pwd . 
Note that a profile segment was created for you. List the 
contents of your home directory and note this new segment. 
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6. Type a period (.). The reply is from the abbrev processor 
confirming the fact that you are in abbrev mode. Quit the abbrev 
mode (.q) and again type a period the see what the commanu 
processor will do with it. Re-enter the abbrev mode. 



/. Create an abbreviation for your User_id by typing a command line 
similar to the following: 

.a HE Student ??.F01 



8. Check your abbreviation via the show request (.s ME). Recall the 
abbrev break characters and observe how they function by typing 
the following lines: 

.s Who is ME? 

.s Who is ME. 

.s Who is MEAN? 

.s Who is ME, the great? 

.s Who is ME the~great? 



9. Use your abbreviation to send yourself a message. For example: 
sm ME Does this work? 



10. Define abbreviations for those users with whom you frequently 
communicate. For example: 

.a S9 Student_09.F01 
.a S4 Student 04.F01 



11. Lis:: all of your abbreviations (.1). List one of your 
abbreviations (.1 ME). List all of your abbreviations that start 
with "S" ( .la S) . 

12. Enter the qedx text editor and write the following text to a 
segment by the name "start_up . ec" . 

start up.ec 



accept_mes sages 
pr int_messages 
abbrev 
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Quit the text editor and type the following command and observe 
the results: 

ec start_up.ec 

If you received any error messages, invoke the qedx editor, read 
the segment start_up.ec, correct your typing errors, rewrite your 
corrected copy, and try again. 

Remember: From now on this start_up.ec will be invoked for you 
(automatically) whenever you log in. 



Using qedx, create another segment named A.ec containing the 
following lines: 

A.ec 



ec start_up. ec 
time 

ec start up.ec 



Quit the text editor and type the following command and observe 
the results: 

ec A.ec 



Execute the print_motd command (pmotd). Note that a 
Person_id .motd segment was created for you (in your home 
directory). It is through this segment that the system knows 
what messages you have already seen. 

Again, execute the print motd command. Since you hsve already 
seen the message of the day, the command will suppress additional 
printings. 



Using the qedx text editor, add the print_motd command to your 
start up.ec. 
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Using the qedx editor, input the following PL/1 source and write 
it to the segment "add.pll": 

add.pH 



add: proc; 

/» Written by Student_?? «/ 

del (sysin, sysprint) file; 

del (I, Sum) fixed bin init (0); 

do while (I >= 0); 
/put skip list ("value? "); 
\get list' (I); 
C3um = Sum +1 ; 

put skip list ("Sum is:", Sum); 
end ; 

put skip list ("Fini"): 
put skip; 
end add; 



Indent the PL/1 source ( ind add.pH). Correct any errors found 
by the indent command and try again. Print the PL/1 source and 
note the indentation that's been done for you. 



Compile add.pll (pll add.pH). Correct any errors found by the 
pn command and try again. 



List the contents of your working directory. Note the segment 
add.pll (created by the text editor) and add (created by the PL/1 
compiler), add.pll is the source segment, and add is the object 
segment . 



Print the contents of the object 
few minutes as the "unprintable" 
octal dump. Each \nnn represents 
is 9 bits, which is one byte. 



segment add. This will take a 
binary code is printed as an 
three octal characters, which 



Execute the PL/1 object program add which is in the object 
segment add (add -or- add$add). Supply positive integer values 
between 0 and 9999 when prompted and observe the results. 
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7. Hit the break key and note the level number in the ready message. 
You are back at the command level — free to do as you please. 
Execute some command such as pwd. 



8. Type the start command (sr). The program add has been re-startec 
at exactly the same point it was at when you hit the break key. 
In other words, the program add is again waiting on you to supply 
integer values. Key in a value and see if the Sum returned is 
consistent with the previous Sums. 

9. Key in a negative valye to stop the program add. Add has 
terminated normally. Note the level number in your ready 
message. (No level number denotes level one.) 



10. Again compile your add.pH source, but use the -table control 
argument (pll add.pll -table). This will allow you to 
symbolically "probe" the object program. 



11. Again execute your program add and supply several positive 
integers as before. Hit the break key. After receiving the 
ready message type the following command: 

probe 

You are now inside the probe debugging subsystem. Note that 
probe printed a small status report about the current state of 
your process. Now type the following sequence of probe requests: 

stack 

This request traces your stack beginning with the most recent 
frame. Note the frame number of add ' s stack frame. Who called 
add, and who did add call? Probe's "current" stack frame is the 
one in which the unexpected event occurred (i.e., frame 10 if 
you're in abbrev mode). Any request that you issue will be 
relative to this stack frame. 

use add 

This request instructs probe to make add's frame (i.e., frame 7 
if you're in nbbrev mode) your "current" stack frame. 
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where 

source 

value I 

value Sum 

let Sum = 500+Sum 

value Sum 

quit 



(Where are you, probe?) 
(Print the "current" source line) 
(What's the value of I?) 
(What's the value of Sum?) 
(Change the value of Sum) 
(What's the new value of Sum?) 
(Quit probe) 



12. You are back at command level. Mote that your level number is 

unchanged. Type "start" and supply another positive integer for 

add. Does the new Sum reflect the change you made while in 

probe? Key in a negative value to stop the program add. 



13. Enter qedx and read the segment >udd>F01 >Student__01 >long. 
Commence printing of the entire segment and then hit the break 
key. After receiving the ready message, type the start command 
and observe the results. 

While the printing continues, again hit the break key. After 
receiving the ready message, type the program_interrupt command 
(pi). You are again in qedx, but at request level. Verify by 
typing 1,5p. Quit the editor. 



14. Print your current search rules (psr). These are the default 
search rules given to users at login. 



15. Note: The following exercise will work properly only if you have 
not executed the who command during this login session. If you 
have executed the who command, type the command: "tmr who". 

Add the name who to your object segment add (an add who). 
Attempt to list the users currently logged in (who). Suffice it 
to say: Do not indiscriminately use command names for your 
program names. 

Remove this extra name from add (dn who), and check to see if who 
command works as usual. If it doesn't work - why doesn't it? 
(For a hint, type: where who) 



16. Terminate (delete) the name who from your initiated segments (tmr 
who) and again attempt to execute the who command. 
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17. Change your search rules to include the directory 
>udd>F01 >Student_01 >tools after your working directory (asr 
>udd>F01 >Student_01 >tools -after working__dir ) . Print your 
current search rules. 



8. Note: The following exercise will work properly only if you have 
not executed the hmu command during this login session. If you 
have executed the hmu command, type the command: "tmr hmu". 

Attempt to list the number of users currently logged in (hmu). 

Suffice it to say: Do not indiscriminately add unfamiliar 
directories to your search rules. 

9. Log out. When you next log in, you will again be given the 
normal default search rules. 
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Log in and type the mail command. Recall that the mail command 
will extract messages and mail . Use this command if and when you 
receive notification that you have mail. 



If you have not received a message requesting partnership, choose 
an F01 user who is currently logged in and send him/her a message 
similar to the following: 

sm Student_07 .F01 May I be your partner? 



Send your partner messages in the dialogue mode, as in the 
following example. Wait for a reply between lines. 

sm Student_07.F01 

How are you doing today? 

That*s good. I*m not doing too bad myself. 
See you later. 



Mail your partner the contents of your add. pi 1 segment. For 
example; 

mail add.pll Student 07.F01 



List the ACL of your add.pll segment (la add.pll). Note: This 
ACL was given automatically by the system when you created 
add.pll. 



When your partner requests access to your add. pi 1 segment (and he 
will), do the following: give your partner read access, verify 
by listing the ACL of your add.pH segment, and send a reply to 
your partner. For example: 

sa add.pll r Student_07 . * . * 
la add.pll 

sm Student_07 -FOI You now have access to add.pll. 



Attempt to print your partner's add.pH segment. For example: 
pr >udd>F01>Student__07>add.pl1 



Request read access to your partner's add.pll segment and attempt 
to print the segment again. (Keep trying until it works) 
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9. Note: Do not proceed until your partner has requested (and has 
been given) access to your add.pll segment. 

Remove your partner's name from your add.pll ACL. For example: 

da add.pH Student_07 . * . * 
Verify the change by again listing the ACL for add.pH 

10. List the ACL on your home directory (la). Who are these users? 
Attempt to set access for yourself on your home directory 
(sa -wd sma Student^?? . * . *) . Why can't you set access on your 
own home directory? 

11. Execute the following commands: 

Is -d 

la Programs 

copy alphabet Programs>A 
Is Programs>** 

Note your access on segment A. 

pr Programs>A 

da Programs Student__?? .FOl . * 

la Programs (What permissions are needed?) 

cr Progriiras>B (What permissions are needed?) 

Is Progriiras>** (What permissions are needed?) 

dl Programs>A (What permissions are needed?) 

pr Programs>A (What permissions are needed?) 

Note that you can do nothing except print the contents of the 
segment A. 

12. Type the following command sequence. (If necessary, include your 
time zone in the -time request. For example: -time "4pra est'*) 

memo 

memo Happiness is Multing the day away. 

memo -time 4pm -alarm It's almost time to go home. 

memo -list 

memo 

13. Modify your start up.ec to include the mail and memo commands. 
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14. Type the following command sequence. 

pat (print_attach_table) 

fo (file_output output_file) 

pat 

ro ( revert_output) 
pr output_file 

Notice the difference in the I/O switch attachments. 



15. Before logging out, check your mailbox. 



W-21 



F01 



WORKSHOP SEVEN 



1. Send yourself the following messages: 

sm ME My working dir is Cwd]. 

sra ME Last message sender was [1ms] 

sm MK The time is [time]. 

sm ME The date is [date] which is the same as [ long__date] . 

sm ME [user name]. [user project] login at [user login_time] . 

sm ME Current user load is [system n_users]. 

sm ME Multics: [system installation__id] . 

sra ME Multics: [system company], 

sm ME The absolute pathname is [path add]. 

sm ME My one-component segments are [segs *]. 

2. Create the following abbreviation: 

.ab reply sm [ last_message__sender ] 
List all of your abbreviations. 

3. Execute the following command lines: 

.s reply Who are you? 
reply Who are you? 

Who in fact was the last_message sender? 
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Create two segments 
following lines: 



"Names A" and "Names B" containing the 



Names A 




Names B 




Now execute the following command lines and observe the results: 
sm ME [contents Names__A3 

create [contents Names_A] [contents Names_B] 
list A» B» 

list [contents Names_A] 
dl [contents Names_A] 
list A» B* 



Create an exec_com segment containing the following text: 

query. ec 



&command__line off 

cwd [response "Working directory desired?"] 

&print Your working directory is: 

pwd 

sm ME [response "What would you like to say to yourself?"] 



The first line of the above exec_com wil] inhibit the printing 
(echoing) of the command lines when the exec_com is executed. 

Now invoke this exec_com and provide legitimate answers to the 
questions asked. Invoke the exec com again, but this time respond 
to the first question by simply hTtting the line feed key. Do you 
understand why you are now back at your home directory? 
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Use qedx to create the following exec_com: 

recur .ec 



&command_line off 

&print ENTRY: &n arguments, first argument is &1 

&if [ngreater &n 0] &then &goto START 

&quit 

&label START 

&print Executing exec_com command 

ec recur. ec &2 &3 &4 &5 &6 &7 &8 

&print EXIT: &n arguments, first argument is &1 

&quit 



Invoke the exec_cora and observe the results by typing: 

ec recur. ec ABCDEFGH 

Change your working directory to your Programs directory and 
again invoke this exec_com by typing: 

ec >udd>F01>Student_??>recur .ec ABC 

Why does the exec_com fail now? Can you correct the problem? 
Try to correct the problem. 



Return to your home directory and execute the following sequence 
of commands 

.ab pl1 ex do "pr &l.pl1;pl1 &1.pll; [entry logout" 

.a F1 >udd>F01 

.1 

pl1__ex F1 >Student_01 >nothing 

The entry active function returns the entryname of the supplied 
pathname. Why was the entry active function used? Was it 
necessary? Why were you logged out? 
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Use command line iteration to send yourself several messages. 
For example, if you are Stuclent_06 type the following line: 

sm Student_0(6 6 6 6). FOl This is number (1 2 3 4)! 

Recall the contents of your segments Names_A and Names_B and 
execute the following command lines: 

sm ME [contents Names_B] 

sm ME ([contents Names_B]) 

list [contents Names__B] 

rename ([contents Names_B]) ([contents Names_A3) 
list A* B* 

create ([contents Names_A] ). [date] . [user name] 

list A».»* 

rename A*.** = . = 

list A».*« 
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The print command only allows one pathname argument such as 
"print add.pll". Use command line iteration to print the 
segments Prince and alphabet as follows: 

print (Prince alphabet) 

Now execute the following command lines to create and test an 
abbreviation for the print command that allows it to accept up to 
five pathnames as arguments. 

.ab :pr do "print (&1 &2 &3 &4 &5)" 

:pr Prince alphabet >udd>F01 >Student__01 >nothing.pl1 

What would happen if the abbrev had been defined as follows: 

.ab print do "print (&1 &2 &3 &4 &5)" 

Try it! When you get the error message, notice the level clause 
of your ready message. Go into probe and execute the "stack" 
request. Do you understand why the stack overflowed? (You will 
probably want to "break" inorder to stop the output from the 
stack request.) Recursion is one reason why command names are 
normally not used for abbreviations. 

Now generalize the print command abbreviation to accept star 
names and test it by typing the following command lines: 

.ab :pr do "print ([segs &13)" 
:pr s*.* 
:pr alphabet 



Modify your start_up,ec to include the three new lines as 
indicated below: 

start up.ec 



&command line off 



{previous contents} 



&print Start_up complete. 
&quit 
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Execute your start__up.ec to verify its proper functioning. 
Execute the new_proc command and observe the results (this may 
take a minute or so) . 



Create the following exec_com and name it weird. ec. 

weird. ec 



&print Beginning &ec_name exec_com 
&if [nequal &n 2] &then &goto LOGOUT 

pwd 
Is 

ind &1 .pll 
pl1 &1.pl1 
pr &1 .pll 
&quit 

&label LOGOUT 
&print Bye Bye 
logout 
&quit 



Execute your weird exec_com using the following command lines 
(you will receive some error messages since sub. pll does not 
exist): 

ec weird. ec add 
ec weird. ec sub 



Add the name weird. absin to your weird. ec segment (an weird. ec 
weird. absin) . Verify by executing the following list commands: 

Is weird. ec 
Is weird. absin 
Is weird.** 
Is w*.** 
Is **.ec 
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8. Submit an absentee request using your weird. absin segment as the 
absin segment. (ear weird. absin -ag add). Attempt to observe 
the absentee process by repeatedly typing: 

who Student_?? 

Hopefully you will notice yourself listed twice, for example: 

Student_08.F01 
Student__08.F01* 

9. After the absentee job has completed, you will find a 
weird. absout segment in the same directory as the weird. absin 
segment. Print and observe its contents. In particular, note 
the login and logout times, and the fact that the absentee 
process used your start_up.ec (which is potentially undesirable). 



I u 



Modify your start up.ec to recognize and respond to an absentee 
login. Add the &i7 control line as indicated. 



start up.ec 



&command_line off 
abbrev 

&if [equal &2 absentee] &then &quit 



11. Submit again an absentee request for weird . absin . This time, 
however, schedule the absentee job for 8 am local time tomorrow 
morning (use your time zone if necessary) . For example: 

ear weird. absin -time "Friday 8am est" -ag add 

12. Execute your weird exec_com using two arguments. For example: 

ec weird. ec add mad 
Why were you logged out? 
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Log in to the system and see if your absentee request from 
yesterday ran as expected. 



Log out using the -hold control argument (logout -hold). Log 
back in. 



Type the following sequence of change_wdir commands. Verify your 
working directory after each line via the print__wdir command. 

cwd < 
cwd < 
cwd 

cwd << 
cwd 

cwd <Student_01 
cwd 



Type the following sequence of commands. (You will receive some 
error messages.) 

cr A.ec B.ec C.ee (create) 

Is »».ec (list) 

an **.ec ==.absin (add_name) 

Is »«.ec (list) 

rn (A B C).ec (a b c).ec (rename) 

Is *».ec (list) 

cr "X Y" »»A«"B»' (create) 

Is » (list) 

rn a.ec ;hmu (rename) 

rn a.ec ";hmu" (rename) 

Is » (list) 



Type the following sequence of commands: (Note: You will 
receive some "Segment not found" error messages) 



wh pwd (where) 

pwd (print wdir) 

wh funny (whereT 

funny (funny) 

in >udd>F01 >Student_01 >funny (initiate) 

wh funny (where) 

funny (funny) 
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6. Type the following sequence of commands: (Note: You will 
receive some "Segment not found" error messages) 

Is -Ik (list) 

Is sad (list) 

sad (sad) 

Ik >udd>F01>Student_01>sad (link) 

Is -Ik (list) 

Is sad (list) 

wh sad (where) 

sad (sad) 

7. Type the following sequence of commands: 

copy Prince P1 (copy) 

list P» (list) 

cpa Prince P1 (compare_ascii) 

ac rd A. archive Prince P1 (archive) 

ac t A. archive (archive) 

list P» (list) 

ac X A. archive (archive) 

list P* (list) 

ss P1 (sort_seg) 

pr PI (print) 

cpa Prince PI (compare_ascii ) 

8. Type the following sequence of commands: 

wh list (where) 
Is [wh list] (list) 

Note the permissions you have on the list command procedure (this 
is the object program). Note also (from the add names) that the 
list command procedure is "bound" (see the bind command) with 
other operating system command procedures. 

9. Type the following sequence of commands. (You will not receive 
any terminal output for the first four commands.) 

fo t_file (file_output) 

pwd (print__wdir ) 

Is -all (list) 

who .F01 (who) 

ro ( revert_output) 

pwd (print wdir) 

pr t file (printT 
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0. Type the following sequence of commands: 



pr Prince 
11 35 
or Prince 
11 80 



(print) 
(line_length) 
(print) 
(line length) 



1. Type the following sequence of commands: 

gr -string »»Done Master!" -set 

pwd 

time 

ru 

gr -revert 
date 



(general_ready) 
(print__wdir ) 
(time) 

(resource_usage) 
( general_ready ) 
(date) 



2. Turn off the ready message (ready_off). Most experienced users 

prefer this mode because they can interact faster. Type the 

following sequence of commands just to get the feel of having no 
ready message: ' 



gq 
gq < 
cwd 

11 79 
an P1 



P2 



>udd>F01 >Student_01 >reassure 
ready 
dn P2 
cr seg_3 

ready__on 
Is seg__3 
logout 



(get_ 
(get__ 
(chan 
( line 
(add_ 
( reas 
(read 
(dele 
(crea 
(peri 
(read 
(list 
(logo 



quota) 

quota) 

ge__wdir ) 

_length) 

name) 

sure) 

y) 

te name) 
teT 
od) 
y on) 
) 

ut) 



{. .} 

V 




Happiness is Mult*ing the day away! 
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